Interfaz servicios externos
Servicio de Comunicación
Hospedajes
Versión: 3.1.2
Servicio de Comunicación
Hospedajes
Versión: 3.1.2
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 2 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Control de versiones
Versión Fecha Autor Descripción / Comentarios
1.0.0 21-04-2022 SGTIC Primera versión
1.0.1 14-07-2022 SGTIC Se modifican los datos de las peticiones.
Se incluyen las operaciones de modificación.
2.0.0 29-09-2022 SGTIC Segunda versión del documento. Se modifica el servicio.
2.2.0 24-11-2022 SGTIC
Se añaden nuevos tipos a las tablas del catálogo.
Se incluyen los formatos de las peticiones para las
operaciones de consulta y anulación.
Se modifica la descripción del bloque respuesta.
Se revisan los códigos de respuesta devueltas por el
servicio.
Se añaden ejemplos de las operaciones de consulta y
anulación.
2.2.1 25-11-2022 SGTIC
Cambio en el contenido de la tabla de códigos Relación
de parentesco.
Se eliminan los códigos de respuesta del servicio 114 y
115 y se añade el código 119.
3.0.0 23-02-2023 SGTIC
Ap.3. Se amplía la descripción de las operaciones del
servicio.
Ap.3.1.1.1. Cambio de validaciones en el alta de partes
de viajeros – el segundo apellido es obligatorio cuando
el tipo de documento es NIF, NIE.
Ap. 3.1.1.3. Cambio en el esquema de petición de alta
de alquileres de vehículos. Opción de indicar un código
de establecimiento como lugar de recogida y devolución
del vehículo.
Ap. 3.1.1.4. Cambio en el esquema de petición de alta
de reservas de vehículos. Opción de indicar un código
de establecimiento como lugar de recogida y devolución
del vehículo.
Ap. 6.2. Se añaden las marcas de vehículos Hyundai y
Silence.
Ap. 6.6. Se añade el tipo de establecimiento
OFIC_VEHIC Oficina de alquiler de vehículos
Se añaden los anexos II y III con ejemplos de peticiones
de consulta y anulación
3.1.0 26-05-2023 SGTIC
Ap. 2. Se amplía la descripción del servicio.
Ap 3. Se crean tres nuevas operaciones del servicio:
consulta de comunicaciones, consulta de lotes y
anulación de comunicaciones de un lote.
Ap. 3.1.1.3. Se inserta el rol de la persona dentro del
bloque datosPersona. Se cambia el orden del dato tipo
del bloque vehiculo para que vaya debajo de categoría.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 2 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Control de versiones
Versión Fecha Autor Descripción / Comentarios
1.0.0 21-04-2022 SGTIC Primera versión
1.0.1 14-07-2022 SGTIC Se modifican los datos de las peticiones.
Se incluyen las operaciones de modificación.
2.0.0 29-09-2022 SGTIC Segunda versión del documento. Se modifica el servicio.
2.2.0 24-11-2022 SGTIC
Se añaden nuevos tipos a las tablas del catálogo.
Se incluyen los formatos de las peticiones para las
operaciones de consulta y anulación.
Se modifica la descripción del bloque respuesta.
Se revisan los códigos de respuesta devueltas por el
servicio.
Se añaden ejemplos de las operaciones de consulta y
anulación.
2.2.1 25-11-2022 SGTIC
Cambio en el contenido de la tabla de códigos Relación
de parentesco.
Se eliminan los códigos de respuesta del servicio 114 y
115 y se añade el código 119.
3.0.0 23-02-2023 SGTIC
Ap.3. Se amplía la descripción de las operaciones del
servicio.
Ap.3.1.1.1. Cambio de validaciones en el alta de partes
de viajeros – el segundo apellido es obligatorio cuando
el tipo de documento es NIF, NIE.
Ap. 3.1.1.3. Cambio en el esquema de petición de alta
de alquileres de vehículos. Opción de indicar un código
de establecimiento como lugar de recogida y devolución
del vehículo.
Ap. 3.1.1.4. Cambio en el esquema de petición de alta
de reservas de vehículos. Opción de indicar un código
de establecimiento como lugar de recogida y devolución
del vehículo.
Ap. 6.2. Se añaden las marcas de vehículos Hyundai y
Silence.
Ap. 6.6. Se añade el tipo de establecimiento
OFIC_VEHIC Oficina de alquiler de vehículos
Se añaden los anexos II y III con ejemplos de peticiones
de consulta y anulación
3.1.0 26-05-2023 SGTIC
Ap. 2. Se amplía la descripción del servicio.
Ap 3. Se crean tres nuevas operaciones del servicio:
consulta de comunicaciones, consulta de lotes y
anulación de comunicaciones de un lote.
Ap. 3.1.1.3. Se inserta el rol de la persona dentro del
bloque datosPersona. Se cambia el orden del dato tipo
del bloque vehiculo para que vaya debajo de categoría.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 3 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Ap. 3.1.1.4. Se cambia el orden del dato tipo del bloque
vehiculo para que vaya debajo de categoría.
Ap. 3.1.2. Se añade el dato ‘anulada’ en el mensaje de
respuesta.
Ap. 4.2. Se cambia la fecha de caducidad de tarjeta por
un campo de texto con formato MM/AAAA.
Ap. 3.1.1.3. La fecha de nacimiento del titular del
contrato y conductores principal y secundario pasa a ser
no obligatoria.
3.1.1 27/06/2024 SGTIC
Ap. 3.1.1.1. y Ap. 3.1.1.2. Se corrige la errata en la
etiqueta documento de los datos de la persona, se
cambia por numeroDocumento
Ap. 3.1.1.1. y Ap. 3.3.2.6. Se corrige la errata en la
descripción de la etiqueta parentesco.
Ap. 4.2. Se cambia la etiqueta fechaCaducidadTarjeta
por caducidadTarjeta.
Ap. 6.2. Se insertan las marcas Cupra, Alpine y MG en
la tabla Marcas de vehículos.
Ap. 3.5. Nueva operación catalogo para la consulta de
tablas de códigos. Se elimina el apartado 6 con el
contenido de las tablas.
Ap. 5. Se actualizan los códigos de error devueltos por
el servicio
3.1.2 17/09/2024 SGTIC
Ap.3.1.1. Solicitud. Se modifica la longitud del campo
correo a 250 caracteres.
Ap. 3.1.1.5. Consulta de lotes y Ap. 3.2.2. Respuesta. Se
modifica el formato de las fechas de salida fechaPeticion
y fechaProcesamiento.
Ap. 5. Códigos de error devueltos por el servicio. Se
eliminan los códigos de error 10104 y 10123. Se añade
el código 10159.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 3 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Ap. 3.1.1.4. Se cambia el orden del dato tipo del bloque
vehiculo para que vaya debajo de categoría.
Ap. 3.1.2. Se añade el dato ‘anulada’ en el mensaje de
respuesta.
Ap. 4.2. Se cambia la fecha de caducidad de tarjeta por
un campo de texto con formato MM/AAAA.
Ap. 3.1.1.3. La fecha de nacimiento del titular del
contrato y conductores principal y secundario pasa a ser
no obligatoria.
3.1.1 27/06/2024 SGTIC
Ap. 3.1.1.1. y Ap. 3.1.1.2. Se corrige la errata en la
etiqueta documento de los datos de la persona, se
cambia por numeroDocumento
Ap. 3.1.1.1. y Ap. 3.3.2.6. Se corrige la errata en la
descripción de la etiqueta parentesco.
Ap. 4.2. Se cambia la etiqueta fechaCaducidadTarjeta
por caducidadTarjeta.
Ap. 6.2. Se insertan las marcas Cupra, Alpine y MG en
la tabla Marcas de vehículos.
Ap. 3.5. Nueva operación catalogo para la consulta de
tablas de códigos. Se elimina el apartado 6 con el
contenido de las tablas.
Ap. 5. Se actualizan los códigos de error devueltos por
el servicio
3.1.2 17/09/2024 SGTIC
Ap.3.1.1. Solicitud. Se modifica la longitud del campo
correo a 250 caracteres.
Ap. 3.1.1.5. Consulta de lotes y Ap. 3.2.2. Respuesta. Se
modifica el formato de las fechas de salida fechaPeticion
y fechaProcesamiento.
Ap. 5. Códigos de error devueltos por el servicio. Se
eliminan los códigos de error 10104 y 10123. Se añade
el código 10159.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 4 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Índice
1. INTRODUCCIÓN ...................................................................................................................... 6
1.1. OBJETO ............................................................................................................................ 6
1.2. ALCANCE.......................................................................................................................... 6
1.3. GLOSARIO ........................................................................................................................ 6
1.4. DOCUMENTOS RELACIONADOS .................................................................................... 7
2. DEFINICIÓN DEL SERVICIO .................................................................................................... 8
2.1. INTERFAZ DEL SERVICIO WEB .................................................................................... 10
2.2. DATOS DE ACCESO AL SERVICIO ............................................................................... 10
2.3. EJEMPLO DE IMPLEMENTACIÓN DE LA PARTE CLIENTE ......................................... 10
3. DESCRIPCIÓN DE LAS OPERACIONES DEL SERVICIO ..................................................... 12
3.1. COMUNICACIÓN ............................................................................................................ 12
3.1.1. Solicitud ................................................................................................................... 13
3.1.2. Respuesta ................................................................................................................ 35
3.2. CONSULTA DE LOTES................................................................................................... 40
3.2.1. Solicitud ................................................................................................................... 40
3.2.2. Respuesta ................................................................................................................ 41
3.3. CONSULTA DE COMUNICACIONES ............................................................................. 45
3.3.1. Solicitud ................................................................................................................... 45
3.3.2. Respuesta ................................................................................................................ 46
3.4. ANULAR COMUNICACIONES DE UN LOTE .................................................................. 61
3.4.1. Solicitud ................................................................................................................... 61
3.4.2. Respuesta ................................................................................................................ 61
3.5. CONSULTAR CATÁLOGO .............................................................................................. 63
3.5.1. Solicitud ................................................................................................................... 63
3.5.2. Respuesta ................................................................................................................ 64
4. FORMATO DE BLOQUES COMUNES EN LOS MENSAJES DE PETICIÓN Y RESPUESTA 67
4.1. BLOQUE DIRECCION ..................................................................................................... 67
4.2. BLOQUE PAGO .............................................................................................................. 68
5. CÓDIGOS DE ERROR DEVUELTOS POR EL SERVICIO...................................................... 69
6. ANEXO I. EJEMPLO DE ALTA DE COMUNICACIONES ........................................................ 70
7. ANEXO II. EJEMPLO DE CONSULTA DE LOTES .................................................................. 73
8. ANEXO III. EJEMPLO DE ANULACIÓN DE COMUNICACIONES .......................................... 75
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 4 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Índice
1. INTRODUCCIÓN ...................................................................................................................... 6
1.1. OBJETO ............................................................................................................................ 6
1.2. ALCANCE.......................................................................................................................... 6
1.3. GLOSARIO ........................................................................................................................ 6
1.4. DOCUMENTOS RELACIONADOS .................................................................................... 7
2. DEFINICIÓN DEL SERVICIO .................................................................................................... 8
2.1. INTERFAZ DEL SERVICIO WEB .................................................................................... 10
2.2. DATOS DE ACCESO AL SERVICIO ............................................................................... 10
2.3. EJEMPLO DE IMPLEMENTACIÓN DE LA PARTE CLIENTE ......................................... 10
3. DESCRIPCIÓN DE LAS OPERACIONES DEL SERVICIO ..................................................... 12
3.1. COMUNICACIÓN ............................................................................................................ 12
3.1.1. Solicitud ................................................................................................................... 13
3.1.2. Respuesta ................................................................................................................ 35
3.2. CONSULTA DE LOTES................................................................................................... 40
3.2.1. Solicitud ................................................................................................................... 40
3.2.2. Respuesta ................................................................................................................ 41
3.3. CONSULTA DE COMUNICACIONES ............................................................................. 45
3.3.1. Solicitud ................................................................................................................... 45
3.3.2. Respuesta ................................................................................................................ 46
3.4. ANULAR COMUNICACIONES DE UN LOTE .................................................................. 61
3.4.1. Solicitud ................................................................................................................... 61
3.4.2. Respuesta ................................................................................................................ 61
3.5. CONSULTAR CATÁLOGO .............................................................................................. 63
3.5.1. Solicitud ................................................................................................................... 63
3.5.2. Respuesta ................................................................................................................ 64
4. FORMATO DE BLOQUES COMUNES EN LOS MENSAJES DE PETICIÓN Y RESPUESTA 67
4.1. BLOQUE DIRECCION ..................................................................................................... 67
4.2. BLOQUE PAGO .............................................................................................................. 68
5. CÓDIGOS DE ERROR DEVUELTOS POR EL SERVICIO...................................................... 69
6. ANEXO I. EJEMPLO DE ALTA DE COMUNICACIONES ........................................................ 70
7. ANEXO II. EJEMPLO DE CONSULTA DE LOTES .................................................................. 73
8. ANEXO III. EJEMPLO DE ANULACIÓN DE COMUNICACIONES .......................................... 75
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 5 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Índice de figuras
Figura 1. Mensajes para la operación comunicacion ....................................................................... 13
Figura 2. Mensaje de petición de la operación comunicacion ......................................................... 14
Figura 3. Fichero XSD para el alta de partes de viajeros ................................................................ 16
Figura 4. Fichero XSD para el alta de reservas de hospedaje......................................................... 20
Figura 5. Fichero XSD para el alta de alquileres de vehículos ........................................................ 24
Figura 6. Fichero XSD para el alta de reservas de vehículos de alquiler ......................................... 29
Figura 7. Fichero XSD para la consulta de peticiones ..................................................................... 34
Figura 8. Fichero XSD para la anulación de comunicaciones.......................................................... 34
Figura 9. Mensaje de respuesta de la operación comunicacion ...................................................... 35
Figura 10. Mensaje de respuesta de la operación comunicación – bloque resultado ...................... 36
Figura 11. Mensaje de respuesta de la operación comunicación – bloque resultadoComunicaciones
....................................................................................................................................................... 37
Figura 12. Mensajes para la operación consultaLote ...................................................................... 40
Figura 13. Mensaje de petición de la operación consultaLote ......................................................... 40
Figura 14. Mensaje de respuesta de la operación consultaLote ...................................................... 41
Figura 15. Mensaje de respuesta de la operación consultaLote – bloque resultadoComunicaciones
....................................................................................................................................................... 42
Figura 16. Mensajes para la operación consultaComunicacion ....................................................... 45
Figura 17. Mensaje de petición de la operación consultaComunicacion.......................................... 45
Figura 18. Mensaje de respuesta de la operación consultaComunicacion ...................................... 47
Figura 19. Mensaje de respuesta de la operación consultaComunicacion – bloque pago ............... 51
Figura 20. Mensaje de respuesta de la operación consultaComunicacion – bloque arrendador...... 52
Figura 21. Mensaje de respuesta de la operación consultaComunicacion – bloque establecimiento
....................................................................................................................................................... 53
Figura 22. Mensaje de respuesta de la operación consultaComunicacion – bloque direccion......... 54
Figura 23. Mensaje de respuesta de la operación consultaComunicacion – bloque infoAlojamiento55
Figura 24. Mensaje de respuesta de la operación consultaComunicacion – bloque persona .......... 56
Figura 25. Mensaje de respuesta de la operación consultaComunicacion – bloque permisoConducir
....................................................................................................................................................... 58
Figura 26. Mensaje de respuesta de la operación consultaComunicacion – bloque vehiculo .......... 59
Figura 27. Mensajes para la operación anulacionLote .................................................................... 61
Figura 28. Mensaje de petición de la operación anulacionLote ....................................................... 61
Figura 29. Mensaje de respuesta de la operación anulacionLote .................................................... 61
Figura 30. Mensajes para la operación catalogo ............................................................................. 63
Figura 31. Mensaje de petición de la operación catalogo ................................................................ 63
Figura 32. Mensaje de respuesta de la operación catalogo ............................................................ 64
Figura 33. Bloque común direccion en mensajes de petición .......................................................... 67
Figura 34. Bloque común pago en mensajes de petición ................................................................ 68
a)
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 5 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Índice de figuras
Figura 1. Mensajes para la operación comunicacion ....................................................................... 13
Figura 2. Mensaje de petición de la operación comunicacion ......................................................... 14
Figura 3. Fichero XSD para el alta de partes de viajeros ................................................................ 16
Figura 4. Fichero XSD para el alta de reservas de hospedaje......................................................... 20
Figura 5. Fichero XSD para el alta de alquileres de vehículos ........................................................ 24
Figura 6. Fichero XSD para el alta de reservas de vehículos de alquiler ......................................... 29
Figura 7. Fichero XSD para la consulta de peticiones ..................................................................... 34
Figura 8. Fichero XSD para la anulación de comunicaciones.......................................................... 34
Figura 9. Mensaje de respuesta de la operación comunicacion ...................................................... 35
Figura 10. Mensaje de respuesta de la operación comunicación – bloque resultado ...................... 36
Figura 11. Mensaje de respuesta de la operación comunicación – bloque resultadoComunicaciones
....................................................................................................................................................... 37
Figura 12. Mensajes para la operación consultaLote ...................................................................... 40
Figura 13. Mensaje de petición de la operación consultaLote ......................................................... 40
Figura 14. Mensaje de respuesta de la operación consultaLote ...................................................... 41
Figura 15. Mensaje de respuesta de la operación consultaLote – bloque resultadoComunicaciones
....................................................................................................................................................... 42
Figura 16. Mensajes para la operación consultaComunicacion ....................................................... 45
Figura 17. Mensaje de petición de la operación consultaComunicacion.......................................... 45
Figura 18. Mensaje de respuesta de la operación consultaComunicacion ...................................... 47
Figura 19. Mensaje de respuesta de la operación consultaComunicacion – bloque pago ............... 51
Figura 20. Mensaje de respuesta de la operación consultaComunicacion – bloque arrendador...... 52
Figura 21. Mensaje de respuesta de la operación consultaComunicacion – bloque establecimiento
....................................................................................................................................................... 53
Figura 22. Mensaje de respuesta de la operación consultaComunicacion – bloque direccion......... 54
Figura 23. Mensaje de respuesta de la operación consultaComunicacion – bloque infoAlojamiento55
Figura 24. Mensaje de respuesta de la operación consultaComunicacion – bloque persona .......... 56
Figura 25. Mensaje de respuesta de la operación consultaComunicacion – bloque permisoConducir
....................................................................................................................................................... 58
Figura 26. Mensaje de respuesta de la operación consultaComunicacion – bloque vehiculo .......... 59
Figura 27. Mensajes para la operación anulacionLote .................................................................... 61
Figura 28. Mensaje de petición de la operación anulacionLote ....................................................... 61
Figura 29. Mensaje de respuesta de la operación anulacionLote .................................................... 61
Figura 30. Mensajes para la operación catalogo ............................................................................. 63
Figura 31. Mensaje de petición de la operación catalogo ................................................................ 63
Figura 32. Mensaje de respuesta de la operación catalogo ............................................................ 64
Figura 33. Bloque común direccion en mensajes de petición .......................................................... 67
Figura 34. Bloque común pago en mensajes de petición ................................................................ 68
a)
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 6 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
1. INTRODUCCIÓN
1.1. OBJETO
El objetivo de este documento es proporcionar una descripción detallada del Servicio de
Comunicación, operaciones que proporciona y mensajes de entrada y salida.
1.2. ALCANCE
El Real Decreto 933/2021, de 26 de octubre, regula las obligaciones de registro documental e
información previstas en la normativa de protección de seguridad ciudadana para las personas
físicas o jurídicas que ejerzan, profesionalmente o no, actividades de hospedaje o alquiler de
vehículos a motor sin conductor, incluidos los operadores turísticos y las plataformas digitales.
Este Real Decreto establece en su Artículo 6 que los sujetos obligados deberán comunicar la
información correspondiente al ejercicio de su actividad de manera inmediata, y en todo caso en un
plazo no superior a 24 horas, respectivamente, a partir de los siguientes momentos:
a) al realizar la reserva o la formalización del contrato o, en su caso, su anulación.
b) al inicio de los servicios contratados.
Para poder enviar las comunicaciones, se debe haber efectuado un registro en el módulo de registro
disponible en la Sede Electrónica del Ministerio del Interior. En este registro, los sujetos obligados
deberán informar de sus datos de empresa o particulares (dependiendo de si ejercen la actividad de
manera profesional o no) y los datos de sus establecimientos o inmuebles.
La Secretaría de Estado de Seguridad pone a disposición de los sujetos obligados un servicio para
el envío de las comunicaciones referentes al ejercicio de su actividad de manera telemática. Los
datos que se deben enviar en las comunicaciones vienen especificados en el Real Decreto, en los
Anexos I y II.
1.3. GLOSARIO
Término Descripción
MIR Ministerio del Interior
RD Real Decreto
ZIP En informática, ZIP o zip es un formato de compresión sin pérdida, muy utilizado para
la compresión de datos como documentos, imágenes o programas.
Para este tipo de archivos se utiliza generalmente la extensión ".zip".
Wikipedia, La enciclopedia libre. Fecha de consulta: octubre 04, 2022
from https://es.wikipedia.org/wiki/Formato_de_compresi%C3%B3n_ZIP
XML XML, siglas en inglés de eXtensible Markup Language, traducido como 'Lenguaje de
Marcado Extensible' o 'Lenguaje de Marcas Extensible', es un metalenguaje que permite
definir lenguajes de marcas desarrollado por el World Wide Web Consortium (W3C)
utilizado para almacenar datos en forma legible.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 6 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
1. INTRODUCCIÓN
1.1. OBJETO
El objetivo de este documento es proporcionar una descripción detallada del Servicio de
Comunicación, operaciones que proporciona y mensajes de entrada y salida.
1.2. ALCANCE
El Real Decreto 933/2021, de 26 de octubre, regula las obligaciones de registro documental e
información previstas en la normativa de protección de seguridad ciudadana para las personas
físicas o jurídicas que ejerzan, profesionalmente o no, actividades de hospedaje o alquiler de
vehículos a motor sin conductor, incluidos los operadores turísticos y las plataformas digitales.
Este Real Decreto establece en su Artículo 6 que los sujetos obligados deberán comunicar la
información correspondiente al ejercicio de su actividad de manera inmediata, y en todo caso en un
plazo no superior a 24 horas, respectivamente, a partir de los siguientes momentos:
a) al realizar la reserva o la formalización del contrato o, en su caso, su anulación.
b) al inicio de los servicios contratados.
Para poder enviar las comunicaciones, se debe haber efectuado un registro en el módulo de registro
disponible en la Sede Electrónica del Ministerio del Interior. En este registro, los sujetos obligados
deberán informar de sus datos de empresa o particulares (dependiendo de si ejercen la actividad de
manera profesional o no) y los datos de sus establecimientos o inmuebles.
La Secretaría de Estado de Seguridad pone a disposición de los sujetos obligados un servicio para
el envío de las comunicaciones referentes al ejercicio de su actividad de manera telemática. Los
datos que se deben enviar en las comunicaciones vienen especificados en el Real Decreto, en los
Anexos I y II.
1.3. GLOSARIO
Término Descripción
MIR Ministerio del Interior
RD Real Decreto
ZIP En informática, ZIP o zip es un formato de compresión sin pérdida, muy utilizado para
la compresión de datos como documentos, imágenes o programas.
Para este tipo de archivos se utiliza generalmente la extensión ".zip".
Wikipedia, La enciclopedia libre. Fecha de consulta: octubre 04, 2022
from https://es.wikipedia.org/wiki/Formato_de_compresi%C3%B3n_ZIP
XML XML, siglas en inglés de eXtensible Markup Language, traducido como 'Lenguaje de
Marcado Extensible' o 'Lenguaje de Marcas Extensible', es un metalenguaje que permite
definir lenguajes de marcas desarrollado por el World Wide Web Consortium (W3C)
utilizado para almacenar datos en forma legible.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 7 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Wikipedia, La enciclopedia libre. Fecha de consulta: octubre 04, 2022 from
https://es.wikipedia.org/wiki/Extensible_Markup_Language
Base64 Base64 es un sistema de numeración posicional que usa 64 como base. Es la mayor
potencia que puede ser representada usando únicamente los caracteres imprimibles
de ASCII. Esto ha propiciado su uso para codificación de correos electrónicos, PGP y
otras aplicaciones.
Wikipedia, La enciclopedia libre. Fecha de consulta: octubre 04, 2022
from https://es.wikipedia.org/wiki/Base64
HTTP El Protocolo de transferencia de hipertexto (en inglés, Hypertext Transfer Protocol,
abreviado HTTP) es el protocolo de comunicación que permite las transferencias de
información a través de archivos (XML, HTML…) en la World Wide Web
Wikipedia, La enciclopedia libre. Fecha de consulta: octubre 04, 2022
from https://es.wikipedia.org/wiki/Protocolo_de_transferencia_de_hipertexto
SSL SSL es el acrónimo de Secure Sockets Layer (capa de sockets seguros), la tecnología
estándar para mantener segura una conexión a Internet, así como para proteger cualquier
información confidencial que se envía entre dos sistemas e impedir que los delincuentes
lean y modifiquen cualquier dato que se transfiera, incluida información que pudiera
considerarse personal
https://www.websecurity.digicert.com/es/es/security-topics/what-is-ssl-tls-https
XSD XSD (XML Schema Definition) es un lenguaje de esquema utilizado para describir la
estructura y las restricciones de los contenidos de los documentos XML de una forma muy
precisa, más allá de las normas sintácticas impuestas por el propio lenguaje XML. Se
consigue así una percepción del tipo de documento con un nivel alto de abstracción.
Wikipedia, La enciclopedia libre. Fecha de consulta: octubre 04, 2022
from https://es.wikipedia.org/wiki/XML_Schema
1.4. DOCUMENTOS RELACIONADOS
/Ubicación/Documento Descripción
https://www.boe.es/eli/es/rd/2021/10/26/933 Real Decreto 933/2021, de 26 de octubre, por el que se
establecen las obligaciones de registro documental e
información de las personas físicas o jurídicas que ejercen
actividades de hospedaje y alquiler de vehículos a motor.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 7 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Wikipedia, La enciclopedia libre. Fecha de consulta: octubre 04, 2022 from
https://es.wikipedia.org/wiki/Extensible_Markup_Language
Base64 Base64 es un sistema de numeración posicional que usa 64 como base. Es la mayor
potencia que puede ser representada usando únicamente los caracteres imprimibles
de ASCII. Esto ha propiciado su uso para codificación de correos electrónicos, PGP y
otras aplicaciones.
Wikipedia, La enciclopedia libre. Fecha de consulta: octubre 04, 2022
from https://es.wikipedia.org/wiki/Base64
HTTP El Protocolo de transferencia de hipertexto (en inglés, Hypertext Transfer Protocol,
abreviado HTTP) es el protocolo de comunicación que permite las transferencias de
información a través de archivos (XML, HTML…) en la World Wide Web
Wikipedia, La enciclopedia libre. Fecha de consulta: octubre 04, 2022
from https://es.wikipedia.org/wiki/Protocolo_de_transferencia_de_hipertexto
SSL SSL es el acrónimo de Secure Sockets Layer (capa de sockets seguros), la tecnología
estándar para mantener segura una conexión a Internet, así como para proteger cualquier
información confidencial que se envía entre dos sistemas e impedir que los delincuentes
lean y modifiquen cualquier dato que se transfiera, incluida información que pudiera
considerarse personal
https://www.websecurity.digicert.com/es/es/security-topics/what-is-ssl-tls-https
XSD XSD (XML Schema Definition) es un lenguaje de esquema utilizado para describir la
estructura y las restricciones de los contenidos de los documentos XML de una forma muy
precisa, más allá de las normas sintácticas impuestas por el propio lenguaje XML. Se
consigue así una percepción del tipo de documento con un nivel alto de abstracción.
Wikipedia, La enciclopedia libre. Fecha de consulta: octubre 04, 2022
from https://es.wikipedia.org/wiki/XML_Schema
1.4. DOCUMENTOS RELACIONADOS
/Ubicación/Documento Descripción
https://www.boe.es/eli/es/rd/2021/10/26/933 Real Decreto 933/2021, de 26 de octubre, por el que se
establecen las obligaciones de registro documental e
información de las personas físicas o jurídicas que ejercen
actividades de hospedaje y alquiler de vehículos a motor.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 8 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
2. DEFINICIÓN DEL SERVICIO
El Servicio de Comunicación ofrece a las aplicaciones que quieran hacer uso de él, la posibilidad de
envío de comunicaciones sobre sus actividades de hospedaje y alquiler de vehículos a motor sin
conductor, la consulta de información previamente enviada y la anulación de comunicaciones.
Dado que la información a aportar difiere según la naturaleza de la actividad, se han clasificado las
comunicaciones en cuatro tipos:
- Partes de entrada de viajeros en establecimientos de hospedaje
- Reservas de viajeros en establecimientos de hospedaje
- Contratos de alquiler de vehículos
- Reservas de alquiler de vehículos
Cada una de estas comunicaciones se identificará de forma única mediante un código de
comunicación, que se generará de forma automática en el momento de alta. Este código servirá
para poder anularla o consultar su información.
El Servicio ofrece dos formas de enviar peticiones:
➢ Peticiones asíncronas:
Este tipo de peticiones se procesan por el sistema de forma asíncrona, es decir, el sistema recibe
la petición y si es correcta, la guarda en base de datos y genera un número de lote que la identifica.
Posteriormente, el sistema dispone de un proceso que leerá las peticiones sin procesar y las irá
tratando una a una.
Cuando el servicio recibe una de estas peticiones, analiza la información enviada para comprobar
ciertos criterios de seguridad, y si todo es correcto, el mensaje de respuesta devolverá en el mensaje
de respuesta un código 0 – ok, que indicará que la petición ha sido recibida correctamente. El
mensaje de respuesta incluirá, además, un número de lote generado por el servicio y que la
identificará de forma única. Si la petición no es correcta, se devolverá el código de error
correspondiente y una descripción de este.
Una petición puede que no sea correcta si, por ejemplo, el código de arrendador enviado no existe
o no le corresponde al usuario, si se indica un tipo de operación que no existe, o un tipo de
comunicación mal codificado.
Los datos de la solicitud deberán ir en el mensaje de petición en un fichero XML, comprimido y
codificado en Base64.
Las operaciones soportadas por lotes son:
- Alta de comunicaciones:
En el fichero XML de la solicitud deberá ir la información de las comunicaciones a dar de
alta. Ver apartado 3.1. Comunicación para más información.
- Anulación de comunicaciones:
En el fichero XML de la solicitud se deberá indicar los códigos de las comunicaciones a
anular. Ver apartado 3.1. Comunicación para más información
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 8 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
2. DEFINICIÓN DEL SERVICIO
El Servicio de Comunicación ofrece a las aplicaciones que quieran hacer uso de él, la posibilidad de
envío de comunicaciones sobre sus actividades de hospedaje y alquiler de vehículos a motor sin
conductor, la consulta de información previamente enviada y la anulación de comunicaciones.
Dado que la información a aportar difiere según la naturaleza de la actividad, se han clasificado las
comunicaciones en cuatro tipos:
- Partes de entrada de viajeros en establecimientos de hospedaje
- Reservas de viajeros en establecimientos de hospedaje
- Contratos de alquiler de vehículos
- Reservas de alquiler de vehículos
Cada una de estas comunicaciones se identificará de forma única mediante un código de
comunicación, que se generará de forma automática en el momento de alta. Este código servirá
para poder anularla o consultar su información.
El Servicio ofrece dos formas de enviar peticiones:
➢ Peticiones asíncronas:
Este tipo de peticiones se procesan por el sistema de forma asíncrona, es decir, el sistema recibe
la petición y si es correcta, la guarda en base de datos y genera un número de lote que la identifica.
Posteriormente, el sistema dispone de un proceso que leerá las peticiones sin procesar y las irá
tratando una a una.
Cuando el servicio recibe una de estas peticiones, analiza la información enviada para comprobar
ciertos criterios de seguridad, y si todo es correcto, el mensaje de respuesta devolverá en el mensaje
de respuesta un código 0 – ok, que indicará que la petición ha sido recibida correctamente. El
mensaje de respuesta incluirá, además, un número de lote generado por el servicio y que la
identificará de forma única. Si la petición no es correcta, se devolverá el código de error
correspondiente y una descripción de este.
Una petición puede que no sea correcta si, por ejemplo, el código de arrendador enviado no existe
o no le corresponde al usuario, si se indica un tipo de operación que no existe, o un tipo de
comunicación mal codificado.
Los datos de la solicitud deberán ir en el mensaje de petición en un fichero XML, comprimido y
codificado en Base64.
Las operaciones soportadas por lotes son:
- Alta de comunicaciones:
En el fichero XML de la solicitud deberá ir la información de las comunicaciones a dar de
alta. Ver apartado 3.1. Comunicación para más información.
- Anulación de comunicaciones:
En el fichero XML de la solicitud se deberá indicar los códigos de las comunicaciones a
anular. Ver apartado 3.1. Comunicación para más información
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 9 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
➢ Peticiones síncronas:
Este tipo de peticiones son procesadas por el servicio en el momento de recibir el mensaje de
petición.
Las operaciones soportadas son:
- Consulta de lotes en formato XML:
Los datos de la solicitud deberán ir en un fichero XML, comprimido y codificado en Base64.
En el fichero XML de la solicitud se deberá indicar los números de lotes a consultar.
El mensaje de respuesta contiene información de los lotes solicitados, se informa del estado
del lote, si ha sido procesado, su fecha de alta, fecha de procesamiento, tipo de petición
enviado, etc. Si el lote solicitado era un lote la operación de alta de comunicaciones,
devolverá información de las comunicaciones creadas y no creadas.
Ver apartado 3.1. Comunicación para más información
- Consulta de lotes:
Permite consultar la información de uno o varios lotes.
En el mensaje de petición se deberán especificar los códigos de lotes a consultar. El mensaje
de respuesta contiene información de los lotes solicitados.
Esta operación ofrece la misma funcionalidad que la anterior, pero en la anterior los lotes a
consultar deben ir incluidos en un fichero XML, comprimido y codificado en Base64, mientras
que en esta petición los códigos de los lotes pueden viajar en el mismo mensaje de petición.
Ver apartado 3.2. Consulta de lotes
- Consulta de comunicaciones:
En el mensaje de petición se deberá informar de los códigos de comunicación que se desea
consultar. El mensaje de respuesta devolverá la información de las comunicaciones
solicitadas.
Ver apartado 3.3. Consulta de comunicaciones
- Anular comunicaciones de un lote:
Esta operación permite anular todas las comunicaciones de un lote. En el mensaje de
petición se deberá informar del código del lote que se desea anular. Solo se permite anular
un lote por petición.
Ver apartado 3.4. Anular comunicaciones de un lote
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 9 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
➢ Peticiones síncronas:
Este tipo de peticiones son procesadas por el servicio en el momento de recibir el mensaje de
petición.
Las operaciones soportadas son:
- Consulta de lotes en formato XML:
Los datos de la solicitud deberán ir en un fichero XML, comprimido y codificado en Base64.
En el fichero XML de la solicitud se deberá indicar los números de lotes a consultar.
El mensaje de respuesta contiene información de los lotes solicitados, se informa del estado
del lote, si ha sido procesado, su fecha de alta, fecha de procesamiento, tipo de petición
enviado, etc. Si el lote solicitado era un lote la operación de alta de comunicaciones,
devolverá información de las comunicaciones creadas y no creadas.
Ver apartado 3.1. Comunicación para más información
- Consulta de lotes:
Permite consultar la información de uno o varios lotes.
En el mensaje de petición se deberán especificar los códigos de lotes a consultar. El mensaje
de respuesta contiene información de los lotes solicitados.
Esta operación ofrece la misma funcionalidad que la anterior, pero en la anterior los lotes a
consultar deben ir incluidos en un fichero XML, comprimido y codificado en Base64, mientras
que en esta petición los códigos de los lotes pueden viajar en el mismo mensaje de petición.
Ver apartado 3.2. Consulta de lotes
- Consulta de comunicaciones:
En el mensaje de petición se deberá informar de los códigos de comunicación que se desea
consultar. El mensaje de respuesta devolverá la información de las comunicaciones
solicitadas.
Ver apartado 3.3. Consulta de comunicaciones
- Anular comunicaciones de un lote:
Esta operación permite anular todas las comunicaciones de un lote. En el mensaje de
petición se deberá informar del código del lote que se desea anular. Solo se permite anular
un lote por petición.
Ver apartado 3.4. Anular comunicaciones de un lote
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 10 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
2.1. INTERFAZ DEL SERVICIO WEB
Los datos de acceso al Servicio de Comunicación en los entornos de pruebas y producción son:
Datos de acceso al Servicio de Comunicación
Endpoint pruebas https://hospedajes.pre-ses.mir.es/hospedajes-web/ws/v1/comunicacion
Endpoint producción https://hospedajes.ses.mir.es/hospedajes-web/ws/v1/comunicacion
2.2. DATOS DE ACCESO AL SERVICIO
Para poder conectarse al servicio, previamente hay que tener en cuenta las siguientes indicaciones:
• Los servicios web publicados implementan seguridad básica HTTP. Esto requiere del envío
de una cabecera con las siguientes características:
o Clave: 'Authorization'
o Valor: 'Basic <token>', con token=usuario:contraseña codificado en Base64
• 2) La comunicación extremo a extremo se establece a través de un túnel SSL para lo que se
requiere de la importación de un certificado provisto en el almacén de certificados de
confianza de la aplicación cliente.
Las credenciales por enviar en la cabecera de las peticiones se obtendrán en el momento del registro
de la entidad en el formulario que la Secretaría de Estado de Seguridad publicará en la Sede
Electrónica del Ministerio del Interior.
2.3. EJEMPLO DE IMPLEMENTACIÓN DE LA PARTE CLIENTE
El sistema que vaya a desarrollar la parte cliente de este servicio web podrá llevar a cabo las
siguientes llamadas al servicio para completar su operativa (esto es un ejemplo de operativa, cada
sistema cliente puede implementar las llamadas al servicio como se ajuste mejor a su modelo de
negocio).
En una primera petición se envía el alta de sus comunicaciones. Debe enviar una petición al servicio
con la operación de comunicación, indicando en los datos de entrada que se trata de un alta de
comunicaciones del tipo que corresponda.
El Servicio de Comunicación le devuelve un número de lote asignado a esa petición.
El sistema de origen envía una petición para consultar el estado del lote, si ha sido procesado
correctamente y los códigos de comunicación asignados a cada una de ellas. Para ello tiene dos
opciones:
1. Enviar una petición a la operación comunicación indicando en el fichero XML el número de
lote.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 10 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
2.1. INTERFAZ DEL SERVICIO WEB
Los datos de acceso al Servicio de Comunicación en los entornos de pruebas y producción son:
Datos de acceso al Servicio de Comunicación
Endpoint pruebas https://hospedajes.pre-ses.mir.es/hospedajes-web/ws/v1/comunicacion
Endpoint producción https://hospedajes.ses.mir.es/hospedajes-web/ws/v1/comunicacion
2.2. DATOS DE ACCESO AL SERVICIO
Para poder conectarse al servicio, previamente hay que tener en cuenta las siguientes indicaciones:
• Los servicios web publicados implementan seguridad básica HTTP. Esto requiere del envío
de una cabecera con las siguientes características:
o Clave: 'Authorization'
o Valor: 'Basic <token>', con token=usuario:contraseña codificado en Base64
• 2) La comunicación extremo a extremo se establece a través de un túnel SSL para lo que se
requiere de la importación de un certificado provisto en el almacén de certificados de
confianza de la aplicación cliente.
Las credenciales por enviar en la cabecera de las peticiones se obtendrán en el momento del registro
de la entidad en el formulario que la Secretaría de Estado de Seguridad publicará en la Sede
Electrónica del Ministerio del Interior.
2.3. EJEMPLO DE IMPLEMENTACIÓN DE LA PARTE CLIENTE
El sistema que vaya a desarrollar la parte cliente de este servicio web podrá llevar a cabo las
siguientes llamadas al servicio para completar su operativa (esto es un ejemplo de operativa, cada
sistema cliente puede implementar las llamadas al servicio como se ajuste mejor a su modelo de
negocio).
En una primera petición se envía el alta de sus comunicaciones. Debe enviar una petición al servicio
con la operación de comunicación, indicando en los datos de entrada que se trata de un alta de
comunicaciones del tipo que corresponda.
El Servicio de Comunicación le devuelve un número de lote asignado a esa petición.
El sistema de origen envía una petición para consultar el estado del lote, si ha sido procesado
correctamente y los códigos de comunicación asignados a cada una de ellas. Para ello tiene dos
opciones:
1. Enviar una petición a la operación comunicación indicando en el fichero XML el número de
lote.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 11 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
2. Enviar una petición a la operación consultaLote, indicando en la propia petición el número
de lote a consultar.
El Servicio de Comunicación devuelve la información solicitada en el mensaje de respuesta.
Una vez que se obtiene la respuesta, el cliente sabrá los códigos de las comunicaciones que se han
creado, y las que han dado error por algún motivo. Las que han dado error no se han grabado en el
sistema, por lo que el cliente deberá enviar una nueva petición de alta con la información corregida.
Si se desea anular una comunicación hay dos posibilidades:
1. Enviar una petición con la operación comunicacion, indicando en el fichero XML los códigos
de las comunicaciones a anular.
2. Enviar una petición con la operación anulacionLote, indicando en la petición el número de
lote a anular. En este caso se anularán todas las comunicaciones de ese lote.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 11 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
2. Enviar una petición a la operación consultaLote, indicando en la propia petición el número
de lote a consultar.
El Servicio de Comunicación devuelve la información solicitada en el mensaje de respuesta.
Una vez que se obtiene la respuesta, el cliente sabrá los códigos de las comunicaciones que se han
creado, y las que han dado error por algún motivo. Las que han dado error no se han grabado en el
sistema, por lo que el cliente deberá enviar una nueva petición de alta con la información corregida.
Si se desea anular una comunicación hay dos posibilidades:
1. Enviar una petición con la operación comunicacion, indicando en el fichero XML los códigos
de las comunicaciones a anular.
2. Enviar una petición con la operación anulacionLote, indicando en la petición el número de
lote a anular. En este caso se anularán todas las comunicaciones de ese lote.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 12 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3. DESCRIPCIÓN DE LAS OPERACIONES DEL SERVICIO
A continuación, se detalla un listado con las operaciones que ofrece el Servicio de Comunicación, a
través de Internet, para proveer la siguiente funcionalidad a aquellas aplicaciones que quieren
consumir o informarse de estos servicios.
3.1. COMUNICACIÓN
Esta operación cubre las funcionalidades correspondientes al envío de comunicaciones, anulación
y consulta de lotes.
El mensaje de petición deberá contener información relativa a su identificación: código de
arrendador y nombre del sistema de origen de la petición. También deberá informar del tipo de
operación a realizar: alta de comunicaciones, anulación de comunicaciones o consulta de lotes. Y
en el caso de una petición de alta de comunicaciones, el tipo de comunicaciones a crear.
Si la operación es de alta de comunicaciones, la información de las comunicaciones deberá enviarse
en un fichero XML que deberá tener un formato adecuado según el tipo de comunicación. Si la
operación es de anular comunicaciones, los códigos de las comunicaciones a anular deberán
enviarse en otro fichero XML con el formato adecuado. Y si la operación es de consulta de lotes, los
números de lotes deberán enviarse en otro fichero XML distinto. El formato de los XML a enviar está
descrito a continuación en este documento.
El mensaje de petición deberá contener información relativa a su identificación:
• código de arrendador.
• nombre del sistema de origen de la petición.
• tipo de operación a realizar: alta de comunicaciones, anulación de comunicaciones o
consulta de lotes.
• tipo de comunicación (solo cuando la operación es de alta de comunicaciones).
• solicitud: fichero XML que deberá tener un formato adecuado según el tipo de operación y
tipo de comunicación. Este fichero XML deberá ser comprimido según el algoritmo ZIP y
codificado en Base64.
En una misma petición de alta se podrán incluir información de una o varias comunicaciones del
mismo tipo: partes de viajeros, reservas de hospedaje, alquiler o reserva de vehículos. El número
máximo de comunicaciones a incluir en una petición será de 100, sin embargo, este valor es un
valor configurable en el servicio, por lo que puede cambiar en un momento determinado si el
administrador del sistema así lo considera.
Una vez que el Servicio de Comunicación recibe la petición, lleva a cabo una serie de validaciones
en los datos de la petición: tipo de comunicación, código de arrendador, tipo de operación a realizar,
formato del fichero XML, etc. Dependiendo de la información enviada puede ocurrir una de estas
dos situaciones:
1. Si existe algún error de validación: el mensaje de respuesta devolverá el código y la
descripción correspondiente al error.
2. Si los datos de la petición son correctos: el mensaje de respuesta devolverá un código de
estado 0-ok, y un número de lote que identificará esa petición.
a. Si la operación solicitada era de envío de comunicaciones o anulación, el servicio se
guarda la petición para su posterior procesamiento.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 12 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3. DESCRIPCIÓN DE LAS OPERACIONES DEL SERVICIO
A continuación, se detalla un listado con las operaciones que ofrece el Servicio de Comunicación, a
través de Internet, para proveer la siguiente funcionalidad a aquellas aplicaciones que quieren
consumir o informarse de estos servicios.
3.1. COMUNICACIÓN
Esta operación cubre las funcionalidades correspondientes al envío de comunicaciones, anulación
y consulta de lotes.
El mensaje de petición deberá contener información relativa a su identificación: código de
arrendador y nombre del sistema de origen de la petición. También deberá informar del tipo de
operación a realizar: alta de comunicaciones, anulación de comunicaciones o consulta de lotes. Y
en el caso de una petición de alta de comunicaciones, el tipo de comunicaciones a crear.
Si la operación es de alta de comunicaciones, la información de las comunicaciones deberá enviarse
en un fichero XML que deberá tener un formato adecuado según el tipo de comunicación. Si la
operación es de anular comunicaciones, los códigos de las comunicaciones a anular deberán
enviarse en otro fichero XML con el formato adecuado. Y si la operación es de consulta de lotes, los
números de lotes deberán enviarse en otro fichero XML distinto. El formato de los XML a enviar está
descrito a continuación en este documento.
El mensaje de petición deberá contener información relativa a su identificación:
• código de arrendador.
• nombre del sistema de origen de la petición.
• tipo de operación a realizar: alta de comunicaciones, anulación de comunicaciones o
consulta de lotes.
• tipo de comunicación (solo cuando la operación es de alta de comunicaciones).
• solicitud: fichero XML que deberá tener un formato adecuado según el tipo de operación y
tipo de comunicación. Este fichero XML deberá ser comprimido según el algoritmo ZIP y
codificado en Base64.
En una misma petición de alta se podrán incluir información de una o varias comunicaciones del
mismo tipo: partes de viajeros, reservas de hospedaje, alquiler o reserva de vehículos. El número
máximo de comunicaciones a incluir en una petición será de 100, sin embargo, este valor es un
valor configurable en el servicio, por lo que puede cambiar en un momento determinado si el
administrador del sistema así lo considera.
Una vez que el Servicio de Comunicación recibe la petición, lleva a cabo una serie de validaciones
en los datos de la petición: tipo de comunicación, código de arrendador, tipo de operación a realizar,
formato del fichero XML, etc. Dependiendo de la información enviada puede ocurrir una de estas
dos situaciones:
1. Si existe algún error de validación: el mensaje de respuesta devolverá el código y la
descripción correspondiente al error.
2. Si los datos de la petición son correctos: el mensaje de respuesta devolverá un código de
estado 0-ok, y un número de lote que identificará esa petición.
a. Si la operación solicitada era de envío de comunicaciones o anulación, el servicio se
guarda la petición para su posterior procesamiento.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 13 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
b. Si la operación solicitada era de consulta de uno o varios lotes, devolverá la
información de esos lotes en el mismo mensaje de respuesta.
Las peticiones correctas se guardan en el sistema y un proceso que se ejecuta periódicamente las
trata, extrae la información del fichero XML indicado en la solicitud y procede a dar de alta en el
sistema las comunicaciones (si la operación solicitada era de alta de comunicaciones), o anula las
comunicaciones (si la operación solicitada era de anulación).
En una operación de alta de comunicaciones, solamente se darán de alta las comunicaciones
cuando la información aportada sea correcta. Si falta alguno de los datos obligatorios, el formato
no es válido o cualquier otro error de validación hará que la comunicación no se inserte en el sistema.
El servicio informará por correo electrónico a la entidad que lanza la petición del error o errores
encontrados.
En la operación de consulta de lotes previamente enviados, en la solicitud se deben indicar el
número o números de lotes a consultar. El servicio devuelve la información de esos lotes: para las
comunicaciones creadas se devolverá un código de comunicación (código que identifica a cada
parte de viajeros, reserva de hospedaje o alquiler de vehículos de forma única); y para las
comunicaciones que no se han creado por contener errores, se informará de los errores
encontrados.
Operación → comunicacion
Figura 1. Mensajes para la operación comunicacion
3.1.1. Solicitud
A continuación se recoge el esquema de validación de la petición que debe recibir el Servicio de
Comunicación. El mensaje a enviar estará formado por dos bloques de información, el bloque
definido como cabecera y el bloque solicitud.
Cliente Servicio de
Comunicación
comunicacionRequest
comunicacionResponse
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 13 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
b. Si la operación solicitada era de consulta de uno o varios lotes, devolverá la
información de esos lotes en el mismo mensaje de respuesta.
Las peticiones correctas se guardan en el sistema y un proceso que se ejecuta periódicamente las
trata, extrae la información del fichero XML indicado en la solicitud y procede a dar de alta en el
sistema las comunicaciones (si la operación solicitada era de alta de comunicaciones), o anula las
comunicaciones (si la operación solicitada era de anulación).
En una operación de alta de comunicaciones, solamente se darán de alta las comunicaciones
cuando la información aportada sea correcta. Si falta alguno de los datos obligatorios, el formato
no es válido o cualquier otro error de validación hará que la comunicación no se inserte en el sistema.
El servicio informará por correo electrónico a la entidad que lanza la petición del error o errores
encontrados.
En la operación de consulta de lotes previamente enviados, en la solicitud se deben indicar el
número o números de lotes a consultar. El servicio devuelve la información de esos lotes: para las
comunicaciones creadas se devolverá un código de comunicación (código que identifica a cada
parte de viajeros, reserva de hospedaje o alquiler de vehículos de forma única); y para las
comunicaciones que no se han creado por contener errores, se informará de los errores
encontrados.
Operación → comunicacion
Figura 1. Mensajes para la operación comunicacion
3.1.1. Solicitud
A continuación se recoge el esquema de validación de la petición que debe recibir el Servicio de
Comunicación. El mensaje a enviar estará formado por dos bloques de información, el bloque
definido como cabecera y el bloque solicitud.
Cliente Servicio de
Comunicación
comunicacionRequest
comunicacionResponse
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 14 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Figura 2. Mensaje de petición de la operación comunicacion
El bloque cabecera contendrá la siguiente información:
• codigoArrendador: código de arrendador asignado por el Sistema de Hospedajes en el
momento de realizar el registro, y que le identifica de forma única como empresa de hospedería,
titular de inmueble, empresa de alquiler de vehículos, plataforma digital u operador turístico.
• aplicación: nombre de la aplicación o sistema origen desde donde se lanza la petición.
• tipoOperacion: tipo de operación a realizar: A – alta, C – consulta, B – anulación.
• tipoComunicacion: tipo de comunicación que se envía, que podrá ser:
o PV – parte de viajeros
o RH – reserva de hospedaje
o AV – alquiler de vehículo
o RV – reserva de vehículo
Este dato obligatorio únicamente para el alta de comunicaciones.
El bloque solicitud contendrá los datos propios de la petición, que variarán dependiendo del tipo de
comunicación y operación a realizar. Se deberán enviar en formato XML, comprimido según el
algoritmo de compresión ZIP y codificado en Base64.
Si el fichero no llega en el formato esperado (comprimido y codificado), el servicio devuelve un error.
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del mensaje de petición.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
peticion cabecera BLOQUE Si Bloque único.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 14 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Figura 2. Mensaje de petición de la operación comunicacion
El bloque cabecera contendrá la siguiente información:
• codigoArrendador: código de arrendador asignado por el Sistema de Hospedajes en el
momento de realizar el registro, y que le identifica de forma única como empresa de hospedería,
titular de inmueble, empresa de alquiler de vehículos, plataforma digital u operador turístico.
• aplicación: nombre de la aplicación o sistema origen desde donde se lanza la petición.
• tipoOperacion: tipo de operación a realizar: A – alta, C – consulta, B – anulación.
• tipoComunicacion: tipo de comunicación que se envía, que podrá ser:
o PV – parte de viajeros
o RH – reserva de hospedaje
o AV – alquiler de vehículo
o RV – reserva de vehículo
Este dato obligatorio únicamente para el alta de comunicaciones.
El bloque solicitud contendrá los datos propios de la petición, que variarán dependiendo del tipo de
comunicación y operación a realizar. Se deberán enviar en formato XML, comprimido según el
algoritmo de compresión ZIP y codificado en Base64.
Si el fichero no llega en el formato esperado (comprimido y codificado), el servicio devuelve un error.
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del mensaje de petición.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
peticion cabecera BLOQUE Si Bloque único.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 15 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
La información a incluir en el fichero XML de la etiqueta solicitud dependerá del tipo de comunicación
y operación solicitada. Este fichero XML se validará contra su correspondiente fichero XSD.
A continuación, se detalla cada uno de estos ficheros XSD, para cada tipo de comunicación y
operación.
Contiene los datos de control
relativos a la petición.
peticion / cabecera arrendador String(10) Si Código del arrendador asignado
por el Sistema de Hospedajes en el
momento del registro.
peticion / cabecera aplicación String(50) Si Nombre del aplicativo cliente que
lanza la petición.
peticion / cabecera tipoOperacion String(1) Si Tipo de operación a realizar.
Valores:
• A – alta
• C – consulta
• B – anulación
peticion / cabecera tipoComunicacion String(2) Si Tipo de comunicaciones a dar de
alta.
Valores:
• PV – partes de viajeros
• AV – alquieres de vehículos
• RH – reservas de hospedaje
• RV – reservas de vehículos
de alquiler
Solo se deberá enviar si el tipo de
operación es alta de comunicaciones.
peticion solicitud Base64 Si Contiene los datos de la solicitud
en formato XML, comprimidos con
el algoritmo ZIP y codificados en
Base64.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 15 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
La información a incluir en el fichero XML de la etiqueta solicitud dependerá del tipo de comunicación
y operación solicitada. Este fichero XML se validará contra su correspondiente fichero XSD.
A continuación, se detalla cada uno de estos ficheros XSD, para cada tipo de comunicación y
operación.
Contiene los datos de control
relativos a la petición.
peticion / cabecera arrendador String(10) Si Código del arrendador asignado
por el Sistema de Hospedajes en el
momento del registro.
peticion / cabecera aplicación String(50) Si Nombre del aplicativo cliente que
lanza la petición.
peticion / cabecera tipoOperacion String(1) Si Tipo de operación a realizar.
Valores:
• A – alta
• C – consulta
• B – anulación
peticion / cabecera tipoComunicacion String(2) Si Tipo de comunicaciones a dar de
alta.
Valores:
• PV – partes de viajeros
• AV – alquieres de vehículos
• RH – reservas de hospedaje
• RV – reservas de vehículos
de alquiler
Solo se deberá enviar si el tipo de
operación es alta de comunicaciones.
peticion solicitud Base64 Si Contiene los datos de la solicitud
en formato XML, comprimidos con
el algoritmo ZIP y codificados en
Base64.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 16 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.1.1.1 Alta de partes de viajeros
➢ Tipo de operación: A
➢ Tipo de comunicación: PV
El fichero XML a enviar cuando se envía una petición del tipo alta de parte de viajeros se validará
contra un fichero XSD con la siguiente estructura:
Figura 3. Fichero XSD para el alta de partes de viajeros
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 16 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.1.1.1 Alta de partes de viajeros
➢ Tipo de operación: A
➢ Tipo de comunicación: PV
El fichero XML a enviar cuando se envía una petición del tipo alta de parte de viajeros se validará
contra un fichero XSD con la siguiente estructura:
Figura 3. Fichero XSD para el alta de partes de viajeros
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 17 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del fichero.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
peticion solicitud BLOQUE Si Contiene los datos de la solicitud
solicitud codigoEstablecimiento String(10) Si Código del establecimiento
asignado por el Sistema de
Hospedajes en el momento del
registro.
solicitud comunicacion BLOQUE Si Bloque que se repite de 1 a n
veces.
Cada bloque contiene la
información de un parte de viajeros.
solicitud /
comunicacion
contrato BLOQUE Si Bloque único.
Contiene los datos del contrato.
solicitud /
comunicacion /
contrato
referencia String(50) Si Número de referencia del contrato.
solicitud /
comunicacion /
contrato
fechaContrato Fecha Si Fecha en la que se formalizó el
contrato.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
contrato
fechaEntrada Fecha Si Fecha y hora de entrada en el
alojamiento.
Formato AAAA-MM-DDThh:mm:ss
solicitud /
comunicacion /
contrato
fechaSalida Fecha Si Fecha de salida del alojamiento.
Formato AAAA-MM-DDThh:mm:ss
solicitud /
comunicacion /
contrato
numPersonas Numérico Si Número de personas alojadas.
solicitud /
comunicacion /
contrato
numHabitaciones Numérico No Número de habitaciones que
ocupan en el alojamiento.
solicitud /
comunicacion /
contrato
internet Booleano No Indica si tienen conexión a internet.
solicitud /
comunicacion /
contrato
pago BLOQUE Si Bloque único.
Contiene los datos del pago.
Su contenido está descrito en el
apartado 4.2. Bloque pago
solicitud /
comunicacion
persona BLOQUE Si Bloque que se repite de 1 a n
veces.
Contiene los datos de una persona
alojada en el establecimiento.
solicitud /
comunicacion /
persona
rol String(2) Si Indicará el rol de la persona en el
contrato. Su valor deberá ser
siempre ‘VI’ (viajero).
solicitud /
comunicacion /
persona
nombre String(50) Si Nombre de la persona
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 17 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del fichero.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
peticion solicitud BLOQUE Si Contiene los datos de la solicitud
solicitud codigoEstablecimiento String(10) Si Código del establecimiento
asignado por el Sistema de
Hospedajes en el momento del
registro.
solicitud comunicacion BLOQUE Si Bloque que se repite de 1 a n
veces.
Cada bloque contiene la
información de un parte de viajeros.
solicitud /
comunicacion
contrato BLOQUE Si Bloque único.
Contiene los datos del contrato.
solicitud /
comunicacion /
contrato
referencia String(50) Si Número de referencia del contrato.
solicitud /
comunicacion /
contrato
fechaContrato Fecha Si Fecha en la que se formalizó el
contrato.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
contrato
fechaEntrada Fecha Si Fecha y hora de entrada en el
alojamiento.
Formato AAAA-MM-DDThh:mm:ss
solicitud /
comunicacion /
contrato
fechaSalida Fecha Si Fecha de salida del alojamiento.
Formato AAAA-MM-DDThh:mm:ss
solicitud /
comunicacion /
contrato
numPersonas Numérico Si Número de personas alojadas.
solicitud /
comunicacion /
contrato
numHabitaciones Numérico No Número de habitaciones que
ocupan en el alojamiento.
solicitud /
comunicacion /
contrato
internet Booleano No Indica si tienen conexión a internet.
solicitud /
comunicacion /
contrato
pago BLOQUE Si Bloque único.
Contiene los datos del pago.
Su contenido está descrito en el
apartado 4.2. Bloque pago
solicitud /
comunicacion
persona BLOQUE Si Bloque que se repite de 1 a n
veces.
Contiene los datos de una persona
alojada en el establecimiento.
solicitud /
comunicacion /
persona
rol String(2) Si Indicará el rol de la persona en el
contrato. Su valor deberá ser
siempre ‘VI’ (viajero).
solicitud /
comunicacion /
persona
nombre String(50) Si Nombre de la persona
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 18 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
solicitud /
comunicacion /
persona
apellido1 String(50) Si Primer apellido de la persona.
solicitud /
comunicacion /
persona
apellido2 String(50) Obligatorio si
el tipo de
documento es
NIF
Segundo apellido de la persona.
solicitud /
comunicacion /
persona
tipoDocumento String(5) Obligatorio si
la persona es
mayor de
edad
Código del tipo de documento de
identidad de la persona.
Para obtener los códigos de los
tipos de documento utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_DOCUMENTO.
solicitud /
comunicacion /
persona
numeroDocumento String(15) Obligatorio si
la persona es
mayor de
edad
Número de documento de identidad
de la persona.
Deberá corresponder al tipo de
documento del campo
tipoDocumento, y tener un formato
válido en el caso de NIF o NIE.
solicitud /
comunicacion /
persona
soporteDocumento String(9) Obligatorio si
el tipo de
documento es
NIF, NIE
Número de soporte del documento
solicitud /
comunicacion /
persona
fechaNacimiento Fecha Si Fecha de nacimiento de la persona.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
persona
nacionalidad String(3) No Código del país de nacionalidad de
la persona.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
solicitud /
comunicacion /
persona
sexo String(1) No Sexo de la persona.
Para obtener los códigos sexo utilice
la operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor SEXO.
solicitud /
comunicacion /
persona
direccion BLOQUE Si Bloque único.
Contiene la dirección del domicilio
particular de la persona.
Su contenido está descrito en el
apartado 4.1. Bloque direccion
solicitud /
comunicacion /
persona
teléfono String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo.
Teléfono de contacto de la persona.
solicitud /
comunicacion /
persona
teléfono2 String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo.
Segundo teléfono de contacto de la
persona.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 18 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
solicitud /
comunicacion /
persona
apellido1 String(50) Si Primer apellido de la persona.
solicitud /
comunicacion /
persona
apellido2 String(50) Obligatorio si
el tipo de
documento es
NIF
Segundo apellido de la persona.
solicitud /
comunicacion /
persona
tipoDocumento String(5) Obligatorio si
la persona es
mayor de
edad
Código del tipo de documento de
identidad de la persona.
Para obtener los códigos de los
tipos de documento utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_DOCUMENTO.
solicitud /
comunicacion /
persona
numeroDocumento String(15) Obligatorio si
la persona es
mayor de
edad
Número de documento de identidad
de la persona.
Deberá corresponder al tipo de
documento del campo
tipoDocumento, y tener un formato
válido en el caso de NIF o NIE.
solicitud /
comunicacion /
persona
soporteDocumento String(9) Obligatorio si
el tipo de
documento es
NIF, NIE
Número de soporte del documento
solicitud /
comunicacion /
persona
fechaNacimiento Fecha Si Fecha de nacimiento de la persona.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
persona
nacionalidad String(3) No Código del país de nacionalidad de
la persona.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
solicitud /
comunicacion /
persona
sexo String(1) No Sexo de la persona.
Para obtener los códigos sexo utilice
la operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor SEXO.
solicitud /
comunicacion /
persona
direccion BLOQUE Si Bloque único.
Contiene la dirección del domicilio
particular de la persona.
Su contenido está descrito en el
apartado 4.1. Bloque direccion
solicitud /
comunicacion /
persona
teléfono String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo.
Teléfono de contacto de la persona.
solicitud /
comunicacion /
persona
teléfono2 String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo.
Segundo teléfono de contacto de la
persona.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 19 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
solicitud /
comunicacion /
persona
correo String(250) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo.
Dirección de correo electrónico de
la persona.
Deberá tener formato de dirección
de correo electrónico válido.
solicitud /
comunicacion /
persona
parentesco String(5) Obligatorio si
la persona es
menor de
edad.
Si alguna de las personas es menor
de edad, al menos una de las
personas mayores de edad ha de
tener informada su relación de
parentesco con esta persona
menor de edad (padre, madre,
abuelo/a, hermano/a,...).
Para obtener los códigos de los
tipos de parentesco utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_PARENTESCO.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 19 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
solicitud /
comunicacion /
persona
correo String(250) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo.
Dirección de correo electrónico de
la persona.
Deberá tener formato de dirección
de correo electrónico válido.
solicitud /
comunicacion /
persona
parentesco String(5) Obligatorio si
la persona es
menor de
edad.
Si alguna de las personas es menor
de edad, al menos una de las
personas mayores de edad ha de
tener informada su relación de
parentesco con esta persona
menor de edad (padre, madre,
abuelo/a, hermano/a,...).
Para obtener los códigos de los
tipos de parentesco utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_PARENTESCO.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 20 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.1.1.2 Alta de reservas de hospedaje
➢ Tipo de operación: A
➢ Tipo de comunicación: RH
Cuando se desea enviar información sobre reservas en establecimientos de hospedaje, el fichero
XML incluido en la etiqueta solicitud se validará contra el siguiente fichero XSD:
Figura 4. Fichero XSD para el alta de reservas de hospedaje
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 20 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.1.1.2 Alta de reservas de hospedaje
➢ Tipo de operación: A
➢ Tipo de comunicación: RH
Cuando se desea enviar información sobre reservas en establecimientos de hospedaje, el fichero
XML incluido en la etiqueta solicitud se validará contra el siguiente fichero XSD:
Figura 4. Fichero XSD para el alta de reservas de hospedaje
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 21 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del fichero.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
peticion solicitud BLOQUE Si Contiene los datos de la solicitud
solicitud comunicacion BLOQUE Si Bloque que se repite de 1 a n
veces.
Cada bloque contiene la
información de una reserva de
hospedaje.
solicitud /
comunicacion
establecimiento BLOQUE Si Bloque único.
Contiene los datos del
establecimiento o inmueble.
solicitud /
comunicacion /
establecimiento
codigo String(10) Obligatorio
incluir la
etiqueta
codigo o
datosEstableci
miento
Código del establecimiento.
Para las entidades que son
empresas de hospedaje, es
obligatorio indicar el código de uno
de sus establecimientos.
Para el resto de entidades se
deberá informar, si se conoce, el
código del establecimiento
asignado por el Sistema de
Hospedajes en el momento del
registro.
solicitud /
comunicacion /
establecimiento
datosEstablecimiento BLOQUE Obligatorio
incluir la
etiqueta
codigo o
datosEstableci
miento
Bloque único.
Contiene los datos del
establecimento en caso de no
disponer de un código de
establecimiento en el Sistema de
Hospedajes.
solicitud /
comunicacion /
establecimiento
datosEstablecimiento
tipo String(10) Si Código del tipo de establecimiento.
Para obtener los códigos de los
tipos de establecimiento utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_ESTABLECIMIENTO.
solicitud /
comunicacion /
establecimiento
datosEstablecimiento
nombre String(50) Si Nombre del establecimiento o
inmueble.
solicitud /
comunicacion /
establecimiento
datosEstablecimiento
direccion BLOQUE Si Bloque único.
Contiene la dirección del
establecimiento o inmueble.
Su contenido está descrito en el
apartado 4.1. Bloque direccion.
solicitud /
comunicacion
contrato BLOQUE Si Bloque único.
Contiene los datos del contrato.
solicitud /
comunicacion /
contrato
referencia String(50) Si Número de referencia del contrato.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 21 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del fichero.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
peticion solicitud BLOQUE Si Contiene los datos de la solicitud
solicitud comunicacion BLOQUE Si Bloque que se repite de 1 a n
veces.
Cada bloque contiene la
información de una reserva de
hospedaje.
solicitud /
comunicacion
establecimiento BLOQUE Si Bloque único.
Contiene los datos del
establecimiento o inmueble.
solicitud /
comunicacion /
establecimiento
codigo String(10) Obligatorio
incluir la
etiqueta
codigo o
datosEstableci
miento
Código del establecimiento.
Para las entidades que son
empresas de hospedaje, es
obligatorio indicar el código de uno
de sus establecimientos.
Para el resto de entidades se
deberá informar, si se conoce, el
código del establecimiento
asignado por el Sistema de
Hospedajes en el momento del
registro.
solicitud /
comunicacion /
establecimiento
datosEstablecimiento BLOQUE Obligatorio
incluir la
etiqueta
codigo o
datosEstableci
miento
Bloque único.
Contiene los datos del
establecimento en caso de no
disponer de un código de
establecimiento en el Sistema de
Hospedajes.
solicitud /
comunicacion /
establecimiento
datosEstablecimiento
tipo String(10) Si Código del tipo de establecimiento.
Para obtener los códigos de los
tipos de establecimiento utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_ESTABLECIMIENTO.
solicitud /
comunicacion /
establecimiento
datosEstablecimiento
nombre String(50) Si Nombre del establecimiento o
inmueble.
solicitud /
comunicacion /
establecimiento
datosEstablecimiento
direccion BLOQUE Si Bloque único.
Contiene la dirección del
establecimiento o inmueble.
Su contenido está descrito en el
apartado 4.1. Bloque direccion.
solicitud /
comunicacion
contrato BLOQUE Si Bloque único.
Contiene los datos del contrato.
solicitud /
comunicacion /
contrato
referencia String(50) Si Número de referencia del contrato.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 22 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
solicitud /
comunicacion /
contrato
fechaContrato Fecha Si Fecha en la que se formalizó el
contrato.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
contrato
fechaEntrada Fecha Si Fecha y hora de entrada en el
alojamiento.
Formato AAAA-MM-DDThh:mm:ss
Si se desconoce la hora de
entrada, enviar AAAA-MM-
DDT00:00:00.
solicitud /
comunicacion /
contrato
fechaSalida Fecha Si Fecha de salida del alojamiento.
Formato AAAA-MM-DDThh:mm:ss
Si se desconoce la hora de salida,
enviar AAAA-MM-DDT00:00:00.
solicitud /
comunicacion /
contrato
numPersonas Numérico Si Número de personas de la reserva.
solicitud /
comunicacion /
contrato
numHabitaciones Numérico No Número de habitaciones
reservadas.
solicitud /
comunicacion /
contrato
internet Booleano No Indica si tienen conexión a internet.
solicitud /
comunicacion /
contrato
pago BLOQUE Si Bloque único.
Contiene los datos del pago.
Su contenido está descrito en el
apartado 4.2. Bloque pago
solicitud /
comunicacion
persona BLOQUE Si Bloque que se repite 1 a n veces.
Se deberá incluir un bloque de este
tipo con la información del titular del
contrato, y tantos bloques como
información de viajeros se
disponga.
solicitud /
comunicacion /
persona
rol String(2) Si Indicará el rol de la persona en la
reserva.
Valores:
• TI – titular del contrato
• VI – viajero
solicitud /
comunicacion /
persona
nombre String(50) Si Nombre de la persona
solicitud /
comunicacion /
persona
apellido1 String(50) Si Primer apellido
solicitud /
comunicacion /
persona
apellido2 String(50) No Segundo apellido
solicitud /
comunicacion /
persona
tipoDocumento String(5) No Código del tipo de documento de
identidad de la persona.
Para obtener los códigos de los
tipos de documento utilice la
operación catalogo, pasándole en
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 22 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
solicitud /
comunicacion /
contrato
fechaContrato Fecha Si Fecha en la que se formalizó el
contrato.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
contrato
fechaEntrada Fecha Si Fecha y hora de entrada en el
alojamiento.
Formato AAAA-MM-DDThh:mm:ss
Si se desconoce la hora de
entrada, enviar AAAA-MM-
DDT00:00:00.
solicitud /
comunicacion /
contrato
fechaSalida Fecha Si Fecha de salida del alojamiento.
Formato AAAA-MM-DDThh:mm:ss
Si se desconoce la hora de salida,
enviar AAAA-MM-DDT00:00:00.
solicitud /
comunicacion /
contrato
numPersonas Numérico Si Número de personas de la reserva.
solicitud /
comunicacion /
contrato
numHabitaciones Numérico No Número de habitaciones
reservadas.
solicitud /
comunicacion /
contrato
internet Booleano No Indica si tienen conexión a internet.
solicitud /
comunicacion /
contrato
pago BLOQUE Si Bloque único.
Contiene los datos del pago.
Su contenido está descrito en el
apartado 4.2. Bloque pago
solicitud /
comunicacion
persona BLOQUE Si Bloque que se repite 1 a n veces.
Se deberá incluir un bloque de este
tipo con la información del titular del
contrato, y tantos bloques como
información de viajeros se
disponga.
solicitud /
comunicacion /
persona
rol String(2) Si Indicará el rol de la persona en la
reserva.
Valores:
• TI – titular del contrato
• VI – viajero
solicitud /
comunicacion /
persona
nombre String(50) Si Nombre de la persona
solicitud /
comunicacion /
persona
apellido1 String(50) Si Primer apellido
solicitud /
comunicacion /
persona
apellido2 String(50) No Segundo apellido
solicitud /
comunicacion /
persona
tipoDocumento String(5) No Código del tipo de documento de
identidad de la persona.
Para obtener los códigos de los
tipos de documento utilice la
operación catalogo, pasándole en
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 23 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
la etiqueta ‘catalogo’ el valor
TIPO_DOCUMENTO.
solicitud /
comunicacion /
persona
numeroDocumento String(15) No Número de documento de identidad
de la persona.
Deberá corresponder al tipo de
documento del campo
tipoDocumento, y tener un formato
válido en el caso de NIF o NIE.
solicitud /
comunicacion /
persona
fechaNacimiento Fecha No Fecha de nacimiento.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
persona
nacionalidad String(3) No Código del país de nacionalidad.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
solicitud /
comunicacion /
persona
sexo String(1) No Sexo.
Para obtener los códigos utilice la
operación catalogo, pasándole en la
etiqueta ‘catalogo’ el valor SEXO.
solicitud /
comunicacion /
persona
direccion BLOQUE No Bloque único.
Contiene la dirección del domicilio
particular.
Su contenido está descrito en el
apartado 4.1. Bloque direccion
solicitud /
comunicacion /
persona
teléfono String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo.
Teléfono de contacto
solicitud /
comunicacion /
persona
teléfono2 String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo.
Segundo teléfono de contacto.
solicitud /
comunicacion /
persona
correo String(250) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo.
Dirección de correo electrónico.
Deberá tener formato de dirección
de correo electrónico válido.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 23 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
la etiqueta ‘catalogo’ el valor
TIPO_DOCUMENTO.
solicitud /
comunicacion /
persona
numeroDocumento String(15) No Número de documento de identidad
de la persona.
Deberá corresponder al tipo de
documento del campo
tipoDocumento, y tener un formato
válido en el caso de NIF o NIE.
solicitud /
comunicacion /
persona
fechaNacimiento Fecha No Fecha de nacimiento.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
persona
nacionalidad String(3) No Código del país de nacionalidad.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
solicitud /
comunicacion /
persona
sexo String(1) No Sexo.
Para obtener los códigos utilice la
operación catalogo, pasándole en la
etiqueta ‘catalogo’ el valor SEXO.
solicitud /
comunicacion /
persona
direccion BLOQUE No Bloque único.
Contiene la dirección del domicilio
particular.
Su contenido está descrito en el
apartado 4.1. Bloque direccion
solicitud /
comunicacion /
persona
teléfono String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo.
Teléfono de contacto
solicitud /
comunicacion /
persona
teléfono2 String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo.
Segundo teléfono de contacto.
solicitud /
comunicacion /
persona
correo String(250) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo.
Dirección de correo electrónico.
Deberá tener formato de dirección
de correo electrónico válido.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 24 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.1.1.3 Alta de alquileres de vehículos
➢ Tipo de operación: A
➢ Tipo de comunicación: AV
Cuando se desea enviar información sobre alquileres de vehículos, el fichero XML incluido en la
etiqueta solicitud se validará contra el siguiente fichero XSD:
Figura 5. Fichero XSD para el alta de alquileres de vehículos
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 24 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.1.1.3 Alta de alquileres de vehículos
➢ Tipo de operación: A
➢ Tipo de comunicación: AV
Cuando se desea enviar información sobre alquileres de vehículos, el fichero XML incluido en la
etiqueta solicitud se validará contra el siguiente fichero XSD:
Figura 5. Fichero XSD para el alta de alquileres de vehículos
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 25 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del fichero.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
peticion solicitud BLOQUE Si Contiene los datos de la solicitud
solicitud comunicacion BLOQUE Si Bloque que se repite 1 a n veces.
Cada bloque contiene los datos de
una comunicación relativa al
alquiler de un vehículo.
solicitud /
comunicacion
contrato BLOQUE Si Bloque único.
Contiene los datos del contrato de
alquiler de vehículo.
solicitud /
comunicacion /
contrato
referencia String(50) Si Número de referencia del contrato.
solicitud /
comunicacion /
contrato
fechaContrato Fecha Si Fecha en la que se formalizó el
contrato.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
contrato
fechaRecogida Fecha Si Fecha de recogida del vehículo.
Formato AAAA-MM-DDThh:mm:ss
solicitud /
comunicacion /
contrato
codigoEstablecimiento
Recogida
String(10) Obligatorio
indicar
codigoEstable
cimientoReco
gida o
direccionReco
gida
Código del establecimiento donde
se efectúa la recogida del vehículo.
solicitud /
comunicacion /
contrato
direccionRecogida BLOQUE Obligatorio
indicar
codigoEstable
cimientoReco
gida o
direccionReco
gida
Bloque único.
Lugar de recogida del vehículo.
Su contenido está descrito en el
apartado 4.1. Bloque dirección.
solicitud /
comunicacion /
contrato
codigoEstablecimiento
Devolucion
String(10) Obligatorio
indicar
codigoEstable
cimientoDevol
ucion o
direccionDevol
ucion
Código del establecimiento donde
se efectúa la devolución del
vehículo.
solicitud /
comunicacion /
contrato
direccionDevolucion BLOQUE Obligatorio
indicar
codigoEstable
cimientoDevol
ucion o
direccionDevol
ucion
Bloque único.
Lugar de devolución del vehículo.
Su contenido está descrito en el
apartado 4.1. Bloque dirección.
solicitud /
comunicacion /
contrato
fechaDevolucion Fecha Si Fecha de devolución del vehículo.
Formato AAAA-MM-DDThh:mm:ss.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 25 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del fichero.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
peticion solicitud BLOQUE Si Contiene los datos de la solicitud
solicitud comunicacion BLOQUE Si Bloque que se repite 1 a n veces.
Cada bloque contiene los datos de
una comunicación relativa al
alquiler de un vehículo.
solicitud /
comunicacion
contrato BLOQUE Si Bloque único.
Contiene los datos del contrato de
alquiler de vehículo.
solicitud /
comunicacion /
contrato
referencia String(50) Si Número de referencia del contrato.
solicitud /
comunicacion /
contrato
fechaContrato Fecha Si Fecha en la que se formalizó el
contrato.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
contrato
fechaRecogida Fecha Si Fecha de recogida del vehículo.
Formato AAAA-MM-DDThh:mm:ss
solicitud /
comunicacion /
contrato
codigoEstablecimiento
Recogida
String(10) Obligatorio
indicar
codigoEstable
cimientoReco
gida o
direccionReco
gida
Código del establecimiento donde
se efectúa la recogida del vehículo.
solicitud /
comunicacion /
contrato
direccionRecogida BLOQUE Obligatorio
indicar
codigoEstable
cimientoReco
gida o
direccionReco
gida
Bloque único.
Lugar de recogida del vehículo.
Su contenido está descrito en el
apartado 4.1. Bloque dirección.
solicitud /
comunicacion /
contrato
codigoEstablecimiento
Devolucion
String(10) Obligatorio
indicar
codigoEstable
cimientoDevol
ucion o
direccionDevol
ucion
Código del establecimiento donde
se efectúa la devolución del
vehículo.
solicitud /
comunicacion /
contrato
direccionDevolucion BLOQUE Obligatorio
indicar
codigoEstable
cimientoDevol
ucion o
direccionDevol
ucion
Bloque único.
Lugar de devolución del vehículo.
Su contenido está descrito en el
apartado 4.1. Bloque dirección.
solicitud /
comunicacion /
contrato
fechaDevolucion Fecha Si Fecha de devolución del vehículo.
Formato AAAA-MM-DDThh:mm:ss.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 26 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Si se desconoce la hora de
devolución, enviar AAA-MM-
DDT00:00:00.
solicitud /
comunicacion /
contrato
pago BLOQUE Si Bloque único.
Contiene los datos del pago.
Su contenido está descrito en el
apartado 4.2. Bloque pago
solicitud /
comunicacion
vehiculo BLOQUE Si Bloque único.
Contiene los datos del vehículo
alquilado.
solicitud /
comunicacion /
vehiculo
categoria String(50) Si Categoría del vehículo según la
clasificación de la empresa de
alquiler.
solicitud /
comunicacion /
vehiculo
tipo String(10) Si Tipo de vehículo.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_VEHICULO.
solicitud /
comunicacion /
vehiculo
marca String(10) Si Marca del vehículo.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_MARCA_VEHICULO.
solicitud /
comunicacion /
vehiculo
modelo String(50) Si Modelo del vehículo.
solicitud /
comunicacion /
vehiculo
matricula String(25) Si Matrícula del vehículo.
solicitud /
comunicacion /
vehiculo
numeroBastidor String(17) Si Número de bastidor.
solicitud /
comunicacion /
vehiculo
color String(10) Si Color del vehículo.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_COLOR.
solicitud /
comunicacion /
vehiculo
kmRecogida Numérico No Número de kilómetros que tiene el
coche en el momento de la
recogida.
solicitud /
comunicacion /
vehiculo
kmDevolución Numérico No Número de kilómetros que tiene el
coche en el momento de la
devolución.
solicitud /
comunicacion /
vehiculo
datosGps String No Datos del GPS del vehículo.
solicitud /
comunicacion
persona BLOQUE Si Bloque que se repite 2 a 3 veces
como máximo.
Se deberá incluir un bloque de este
tipo con los datos del titular del
contrato, y otro con los datos del
conductor principal.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 26 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Si se desconoce la hora de
devolución, enviar AAA-MM-
DDT00:00:00.
solicitud /
comunicacion /
contrato
pago BLOQUE Si Bloque único.
Contiene los datos del pago.
Su contenido está descrito en el
apartado 4.2. Bloque pago
solicitud /
comunicacion
vehiculo BLOQUE Si Bloque único.
Contiene los datos del vehículo
alquilado.
solicitud /
comunicacion /
vehiculo
categoria String(50) Si Categoría del vehículo según la
clasificación de la empresa de
alquiler.
solicitud /
comunicacion /
vehiculo
tipo String(10) Si Tipo de vehículo.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_VEHICULO.
solicitud /
comunicacion /
vehiculo
marca String(10) Si Marca del vehículo.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_MARCA_VEHICULO.
solicitud /
comunicacion /
vehiculo
modelo String(50) Si Modelo del vehículo.
solicitud /
comunicacion /
vehiculo
matricula String(25) Si Matrícula del vehículo.
solicitud /
comunicacion /
vehiculo
numeroBastidor String(17) Si Número de bastidor.
solicitud /
comunicacion /
vehiculo
color String(10) Si Color del vehículo.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_COLOR.
solicitud /
comunicacion /
vehiculo
kmRecogida Numérico No Número de kilómetros que tiene el
coche en el momento de la
recogida.
solicitud /
comunicacion /
vehiculo
kmDevolución Numérico No Número de kilómetros que tiene el
coche en el momento de la
devolución.
solicitud /
comunicacion /
vehiculo
datosGps String No Datos del GPS del vehículo.
solicitud /
comunicacion
persona BLOQUE Si Bloque que se repite 2 a 3 veces
como máximo.
Se deberá incluir un bloque de este
tipo con los datos del titular del
contrato, y otro con los datos del
conductor principal.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 27 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Si se dispone de información sobre
un segundo conductor, se incluirá
un bloque más con su información.
solicitud /
comunicacion /
persona
datosPersona BLOQUE Si Bloque único.
Contiene los datos personales de la
persona.
solicitud /
comunicacion /
persona /
datosPersona
rol String(1) Si Indicará el rol de la persona.
Valores:
• CP – conductor principal
• CS – conductor secundario
• TI – titular del contrato
solicitud /
comunicacion /
persona /
datosPersona
nombre String(50) Si Nombre de la persona
solicitud /
comunicacion /
persona /
datosPersona
apellido1 String(50) Si Primer apellido de la persona.
solicitud /
comunicacion /
persona /
datosPersona
apellido2 String(50) Obligatorio si
el tipo de
documento es
NIF
Segundo apellido de la persona.
solicitud /
comunicacion /
persona /
datosPersona
tipoDocumento String(5) Si Código del tipo de documento de
identidad de la persona.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_DOCUMENTO.
solicitud /
comunicacion /
persona /
datosPersona
numeroDocumento String(15) Si Número de documento de identidad
de la persona.
Deberá corresponder al tipo de
documento del campo
tipoDocumento, y tener un formato
válido en el caso de NIF o NIE.
solicitud /
comunicacion /
persona /
datosPersona
fechaNacimiento Fecha No Fecha de nacimiento.
solicitud /
comunicacion /
persona /
datosPersona
nacionalidad String(3) No Código del país de nacionalidad de
la persona.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
solicitud /
comunicacion /
persona /
datosPersona
sexo String(1) No Sexo de la persona.
Para obtener los códigos utilice la
operación catalogo, pasándole en la
etiqueta ‘catalogo’ el valor SEXO.
solicitud /
comunicacion /
persona /
datosPersona
direccion BLOQUE Si Bloque único.
Contiene la dirección del domicilio
particular de la persona.
Su contenido está descrito en el
apartado 4.1. Bloque dirección
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 27 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Si se dispone de información sobre
un segundo conductor, se incluirá
un bloque más con su información.
solicitud /
comunicacion /
persona
datosPersona BLOQUE Si Bloque único.
Contiene los datos personales de la
persona.
solicitud /
comunicacion /
persona /
datosPersona
rol String(1) Si Indicará el rol de la persona.
Valores:
• CP – conductor principal
• CS – conductor secundario
• TI – titular del contrato
solicitud /
comunicacion /
persona /
datosPersona
nombre String(50) Si Nombre de la persona
solicitud /
comunicacion /
persona /
datosPersona
apellido1 String(50) Si Primer apellido de la persona.
solicitud /
comunicacion /
persona /
datosPersona
apellido2 String(50) Obligatorio si
el tipo de
documento es
NIF
Segundo apellido de la persona.
solicitud /
comunicacion /
persona /
datosPersona
tipoDocumento String(5) Si Código del tipo de documento de
identidad de la persona.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_DOCUMENTO.
solicitud /
comunicacion /
persona /
datosPersona
numeroDocumento String(15) Si Número de documento de identidad
de la persona.
Deberá corresponder al tipo de
documento del campo
tipoDocumento, y tener un formato
válido en el caso de NIF o NIE.
solicitud /
comunicacion /
persona /
datosPersona
fechaNacimiento Fecha No Fecha de nacimiento.
solicitud /
comunicacion /
persona /
datosPersona
nacionalidad String(3) No Código del país de nacionalidad de
la persona.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
solicitud /
comunicacion /
persona /
datosPersona
sexo String(1) No Sexo de la persona.
Para obtener los códigos utilice la
operación catalogo, pasándole en la
etiqueta ‘catalogo’ el valor SEXO.
solicitud /
comunicacion /
persona /
datosPersona
direccion BLOQUE Si Bloque único.
Contiene la dirección del domicilio
particular de la persona.
Su contenido está descrito en el
apartado 4.1. Bloque dirección
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 28 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
solicitud /
comunicacion /
persona /
datosPersona
telefono String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo
Teléfono de contacto de la persona.
solicitud /
comunicacion /
persona /
datosPersona
telefono2 String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo
Segundo teléfono de contacto de la
persona.
solicitud /
comunicacion /
persona /
datosPersona
correo String(250) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo
Dirección de correo electrónico de
la persona.
Deberá tener formato de dirección
de correo electrónico válido.
solicitud /
comunicacion /
persona
permisoConducir BLOQUE Obligatorio si
el rol de la
persona es
CD o CS
Bloque único.
Contiene la información sobre el
permiso de conducir.
solicitud /
comunicacion /
persona /
permisoConducir
tipo String(5) Si Tipo de permiso de conducir.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_PERMISO_CONDUCIR.
solicitud /
comunicacion /
persona /
permisoConducir
validez Fecha Si Fecha de validez del permiso de
conducir.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
persona /
permisoConducir
numero String(25) Si Número de permiso de conducir.
solicitud /
comunicacion /
persona /
permisoConducir
soporte String(25) No Número de soporte del permiso.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 28 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
solicitud /
comunicacion /
persona /
datosPersona
telefono String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo
Teléfono de contacto de la persona.
solicitud /
comunicacion /
persona /
datosPersona
telefono2 String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo
Segundo teléfono de contacto de la
persona.
solicitud /
comunicacion /
persona /
datosPersona
correo String(250) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo
Dirección de correo electrónico de
la persona.
Deberá tener formato de dirección
de correo electrónico válido.
solicitud /
comunicacion /
persona
permisoConducir BLOQUE Obligatorio si
el rol de la
persona es
CD o CS
Bloque único.
Contiene la información sobre el
permiso de conducir.
solicitud /
comunicacion /
persona /
permisoConducir
tipo String(5) Si Tipo de permiso de conducir.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_PERMISO_CONDUCIR.
solicitud /
comunicacion /
persona /
permisoConducir
validez Fecha Si Fecha de validez del permiso de
conducir.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
persona /
permisoConducir
numero String(25) Si Número de permiso de conducir.
solicitud /
comunicacion /
persona /
permisoConducir
soporte String(25) No Número de soporte del permiso.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 29 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.1.1.4 Alta de reservas de vehículos
➢ Tipo de operación: A
➢ Tipo de comunicación: RV
Cuando se desea enviar información sobre reservas de vehículos de alquiler, el fichero XML incluido
en la etiqueta solicitud se validará contra el siguiente fichero XSD:
Figura 6. Fichero XSD para el alta de reservas de vehículos de alquiler
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 29 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.1.1.4 Alta de reservas de vehículos
➢ Tipo de operación: A
➢ Tipo de comunicación: RV
Cuando se desea enviar información sobre reservas de vehículos de alquiler, el fichero XML incluido
en la etiqueta solicitud se validará contra el siguiente fichero XSD:
Figura 6. Fichero XSD para el alta de reservas de vehículos de alquiler
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 30 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del fichero.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
peticion solicitud BLOQUE Si Contiene los datos de la solicitud
solicitud comunicacion BLOQUE Si Bloque que se repite 1 a n veces.
Cada bloque contiene los datos de
una reserva de un vehículo de
alquiler.
solicitud /
comunicacion
contrato BLOQUE Si Bloque único.
Contiene los datos del contrato.
solicitud /
comunicacion /
contrato
referencia String(50) Si Número de referencia del contrato.
solicitud /
comunicacion /
contrato
fechaContrato Fecha Si Fecha en la que se formalizó el
contrato.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
contrato
fechaRecogida Fecha Si Fecha de recogida del vehículo.
Formato AAAA-MM-DDThh:mm:ss.
Si se desconoce la hora de
recogida del vehículo, enviar
AAAA-MM-DDT00:00:00.
solicitud /
comunicacion /
contrato
codigoEstablecimiento
Recogida
String(10) Obligatorio
indicar
codigoEstable
cimientoReco
gida o
direccionReco
gida
Código del establecimiento donde
se efectúa la recogida del vehículo.
solicitud /
comunicacion /
contrato
direccionRecogida BLOQUE Obligatorio
indicar
codigoEstable
cimientoReco
gida o
direccionReco
gida
Bloque único.
Lugar de recogida del vehículo.
Su contenido está descrito en el
apartado 4.1. Bloque dirección.
solicitud /
comunicacion /
contrato
codigoEstablecimiento
Devolucion
String(10) Obligatorio
indicar
codigoEstable
cimientoDevol
ucion o
direccionDevol
ucion
Código del establecimiento donde
se efectúa la devolución del
vehículo.
solicitud /
comunicacion /
contrato
direccionDevolucion BLOQUE Obligatorio
indicar
codigoEstable
cimientoDevol
ucion o
direccionDevol
ucion
Bloque único.
Lugar de devolución del vehículo.
Su contenido está descrito en el
apartado 4.1. Bloque dirección.
solicitud /
comunicacion /
contrato
fechaDevolucion Fecha Si Fecha de devolución del vehículo.
Formato AAAA-MM-DDThh:mm:ss.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 30 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del fichero.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
peticion solicitud BLOQUE Si Contiene los datos de la solicitud
solicitud comunicacion BLOQUE Si Bloque que se repite 1 a n veces.
Cada bloque contiene los datos de
una reserva de un vehículo de
alquiler.
solicitud /
comunicacion
contrato BLOQUE Si Bloque único.
Contiene los datos del contrato.
solicitud /
comunicacion /
contrato
referencia String(50) Si Número de referencia del contrato.
solicitud /
comunicacion /
contrato
fechaContrato Fecha Si Fecha en la que se formalizó el
contrato.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
contrato
fechaRecogida Fecha Si Fecha de recogida del vehículo.
Formato AAAA-MM-DDThh:mm:ss.
Si se desconoce la hora de
recogida del vehículo, enviar
AAAA-MM-DDT00:00:00.
solicitud /
comunicacion /
contrato
codigoEstablecimiento
Recogida
String(10) Obligatorio
indicar
codigoEstable
cimientoReco
gida o
direccionReco
gida
Código del establecimiento donde
se efectúa la recogida del vehículo.
solicitud /
comunicacion /
contrato
direccionRecogida BLOQUE Obligatorio
indicar
codigoEstable
cimientoReco
gida o
direccionReco
gida
Bloque único.
Lugar de recogida del vehículo.
Su contenido está descrito en el
apartado 4.1. Bloque dirección.
solicitud /
comunicacion /
contrato
codigoEstablecimiento
Devolucion
String(10) Obligatorio
indicar
codigoEstable
cimientoDevol
ucion o
direccionDevol
ucion
Código del establecimiento donde
se efectúa la devolución del
vehículo.
solicitud /
comunicacion /
contrato
direccionDevolucion BLOQUE Obligatorio
indicar
codigoEstable
cimientoDevol
ucion o
direccionDevol
ucion
Bloque único.
Lugar de devolución del vehículo.
Su contenido está descrito en el
apartado 4.1. Bloque dirección.
solicitud /
comunicacion /
contrato
fechaDevolucion Fecha Si Fecha de devolución del vehículo.
Formato AAAA-MM-DDThh:mm:ss.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 31 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Si se desconoce la hora de
devolución del vehículo, enviar
AAAA-MM-DDT00:00:00.
solicitud /
comunicacion /
contrato
pago BLOQUE Si Bloque único.
Contiene los datos del pago.
Su contenido está descrito en el
apartado 4.2. Bloque pago
solicitud /
comunicacion
vehiculo BLOQUE Si Bloque único.
Contiene los datos del vehículo
reservado.
solicitud /
comunicacion /
vehiculo
categoria String(50) Si Categoría del vehículo según la
clasificación de la empresa de
alquiler.
solicitud /
comunicacion /
vehiculo
tipo String(10) No Tipo de vehículo.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_VEHICULO.
solicitud /
comunicacion /
vehiculo
marca String(10) No Marca del vehículo.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_MARCA_VEHICULO..
solicitud /
comunicacion /
vehiculo
modelo String(50) No Modelo del vehículo.
solicitud /
comunicacion /
vehiculo
matricula String(25) No Matrícula del vehículo.
solicitud /
comunicacion /
vehiculo
numeroBastidor String(17) No Número de bastidor.
solicitud /
comunicacion /
vehiculo
color String(10) No Color del vehículo.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_COLOR.
solicitud /
comunicacion /
vehiculo
kmRecogida Numérico No Número de kilómetros que tiene el
coche en el momento de la
recogida.
solicitud /
comunicacion /
vehiculo
kmDevolucion Numérico No Número de kilómetros que tiene el
coche en el momento de la
devolución.
solicitud /
comunicacion /
vehiculo
datosGps String No Datos del GPS del vehículo.
solicitud /
comunicacion
persona BLOQUE Si Bloque que se repite 1 a 3 veces
como máximo.
Se deberá incluir un bloque de este
tipo con los datos del titular del
contrato.
Si se dispone de información sobre
el conductor principal o segundo
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 31 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Si se desconoce la hora de
devolución del vehículo, enviar
AAAA-MM-DDT00:00:00.
solicitud /
comunicacion /
contrato
pago BLOQUE Si Bloque único.
Contiene los datos del pago.
Su contenido está descrito en el
apartado 4.2. Bloque pago
solicitud /
comunicacion
vehiculo BLOQUE Si Bloque único.
Contiene los datos del vehículo
reservado.
solicitud /
comunicacion /
vehiculo
categoria String(50) Si Categoría del vehículo según la
clasificación de la empresa de
alquiler.
solicitud /
comunicacion /
vehiculo
tipo String(10) No Tipo de vehículo.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_VEHICULO.
solicitud /
comunicacion /
vehiculo
marca String(10) No Marca del vehículo.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_MARCA_VEHICULO..
solicitud /
comunicacion /
vehiculo
modelo String(50) No Modelo del vehículo.
solicitud /
comunicacion /
vehiculo
matricula String(25) No Matrícula del vehículo.
solicitud /
comunicacion /
vehiculo
numeroBastidor String(17) No Número de bastidor.
solicitud /
comunicacion /
vehiculo
color String(10) No Color del vehículo.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_COLOR.
solicitud /
comunicacion /
vehiculo
kmRecogida Numérico No Número de kilómetros que tiene el
coche en el momento de la
recogida.
solicitud /
comunicacion /
vehiculo
kmDevolucion Numérico No Número de kilómetros que tiene el
coche en el momento de la
devolución.
solicitud /
comunicacion /
vehiculo
datosGps String No Datos del GPS del vehículo.
solicitud /
comunicacion
persona BLOQUE Si Bloque que se repite 1 a 3 veces
como máximo.
Se deberá incluir un bloque de este
tipo con los datos del titular del
contrato.
Si se dispone de información sobre
el conductor principal o segundo
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 32 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
conductor se incluirán bloques con
su información.
solicitud /
comunicacion /
persona
datosPersona BLOQUE Si Bloque único.
Contiene los datos personales de la
persona.
solicitud /
comunicacion /
persona /
datosPersona
rol String(1) Si Indicará el rol de la persona.
Valores:
• CP – conductor principal
• CS – conductor secundario
• TI – titular del contrato
solicitud /
comunicacion /
persona /
datosPersona
nombre String(50) Si Nombre de la persona
solicitud /
comunicacion /
persona /
datosPersona
apellido1 String(50) Si Primer apellido de la persona.
solicitud /
comunicacion /
persona /
datosPersona
apellido2 String(50) No. Segundo apellido de la persona.
solicitud /
comunicacion /
persona /
datosPersona
tipoDocumento String(5) No Código del tipo de documento de
identidad de la persona.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_DOCUMENTO.
solicitud /
comunicacion /
persona /
datosPersona
numeroDocumento String(15) No Número de documento de identidad
de la persona.
Deberá corresponder al tipo de
documento del campo
tipoDocumento, y tener un formato
válido en el caso de NIF o NIE.
solicitud /
comunicacion /
persona /
datosPersona
fechaNacimiento Fecha No Fecha de nacimiento.
Formato AAAA-MM-DD
solicitud /
comunicacion /
persona /
datosPersona
nacionalidad String No Código del país de nacionalidad de
la persona.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
solicitud /
comunicacion /
persona /
datosPersona
sexo String(1) No Sexo de la persona.
Para obtener los códigos utilice la
operación catalogo, pasándole en la
etiqueta ‘catalogo’ el valor SEXO.
solicitud /
comunicacion /
persona /
datosPersona
direccion BLOQUE No Bloque único.
Contiene la dirección del domicilio
particular de la persona.
Su contenido está descrito en el
apartado 4.1. Bloque dirección
solicitud /
comunicacion /
teléfono String(20) Obligatorio
incluir una de
Teléfono de contacto de la persona.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 32 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
conductor se incluirán bloques con
su información.
solicitud /
comunicacion /
persona
datosPersona BLOQUE Si Bloque único.
Contiene los datos personales de la
persona.
solicitud /
comunicacion /
persona /
datosPersona
rol String(1) Si Indicará el rol de la persona.
Valores:
• CP – conductor principal
• CS – conductor secundario
• TI – titular del contrato
solicitud /
comunicacion /
persona /
datosPersona
nombre String(50) Si Nombre de la persona
solicitud /
comunicacion /
persona /
datosPersona
apellido1 String(50) Si Primer apellido de la persona.
solicitud /
comunicacion /
persona /
datosPersona
apellido2 String(50) No. Segundo apellido de la persona.
solicitud /
comunicacion /
persona /
datosPersona
tipoDocumento String(5) No Código del tipo de documento de
identidad de la persona.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_DOCUMENTO.
solicitud /
comunicacion /
persona /
datosPersona
numeroDocumento String(15) No Número de documento de identidad
de la persona.
Deberá corresponder al tipo de
documento del campo
tipoDocumento, y tener un formato
válido en el caso de NIF o NIE.
solicitud /
comunicacion /
persona /
datosPersona
fechaNacimiento Fecha No Fecha de nacimiento.
Formato AAAA-MM-DD
solicitud /
comunicacion /
persona /
datosPersona
nacionalidad String No Código del país de nacionalidad de
la persona.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
solicitud /
comunicacion /
persona /
datosPersona
sexo String(1) No Sexo de la persona.
Para obtener los códigos utilice la
operación catalogo, pasándole en la
etiqueta ‘catalogo’ el valor SEXO.
solicitud /
comunicacion /
persona /
datosPersona
direccion BLOQUE No Bloque único.
Contiene la dirección del domicilio
particular de la persona.
Su contenido está descrito en el
apartado 4.1. Bloque dirección
solicitud /
comunicacion /
teléfono String(20) Obligatorio
incluir una de
Teléfono de contacto de la persona.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 33 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
persona /
datosPersona
estas tres
etiquetas:
telefono,
telefono2 o
correo
solicitud /
comunicacion /
persona /
datosPersona
teléfono2 String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo
Segundo teléfono de contacto de la
persona.
solicitud /
comunicacion /
persona /
datosPersona
correo String(250) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo
Dirección de correo electrónico de
la persona.
Deberá tener formato de dirección
de correo electrónico válido.
solicitud /
comunicacion /
persona
permisoConducir BLOQUE No Bloque único.
Contiene la información sobre el
permiso de conducir.
solicitud /
comunicacion /
persona /
permisoConducir
tipo String(5) No Tipo de permiso de conducir.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_PERMISO_CONDUCIR.
solicitud /
comunicacion /
persona /
permisoConducir
validez Fecha No Fecha de validez del permiso de
conducir.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
persona /
permisoConducir
numero String(25) No Número de permiso de conducir.
solicitud /
comunicacion /
persona /
permisoConducir
soporte String(25) No Número de soporte del permiso.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 33 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
persona /
datosPersona
estas tres
etiquetas:
telefono,
telefono2 o
correo
solicitud /
comunicacion /
persona /
datosPersona
teléfono2 String(20) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo
Segundo teléfono de contacto de la
persona.
solicitud /
comunicacion /
persona /
datosPersona
correo String(250) Obligatorio
incluir una de
estas tres
etiquetas:
telefono,
telefono2 o
correo
Dirección de correo electrónico de
la persona.
Deberá tener formato de dirección
de correo electrónico válido.
solicitud /
comunicacion /
persona
permisoConducir BLOQUE No Bloque único.
Contiene la información sobre el
permiso de conducir.
solicitud /
comunicacion /
persona /
permisoConducir
tipo String(5) No Tipo de permiso de conducir.
Para obtener los códigos utilice la
operación catalogo, pasándole en
la etiqueta ‘catalogo’ el valor
TIPO_PERMISO_CONDUCIR.
solicitud /
comunicacion /
persona /
permisoConducir
validez Fecha No Fecha de validez del permiso de
conducir.
Formato AAAA-MM-DD.
solicitud /
comunicacion /
persona /
permisoConducir
numero String(25) No Número de permiso de conducir.
solicitud /
comunicacion /
persona /
permisoConducir
soporte String(25) No Número de soporte del permiso.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 34 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.1.1.5 Consulta de lotes
➢ Tipo de operación: C
El sistema permite la consulta de una o varias peticiones de alta previamente enviadas. Para ello se
deberá informar de los números de lotes devueltos por el servicio en el mensaje de respuesta de
cada una de ellas. El número de lotes máximo a consultar por operación será de 10.
Para cada petición, el servicio informará de su estado: si ha sido procesado, devolverá información
de las comunicaciones enviadas y su estado, si han sido procesadas correctamente, se enviará el
código que la identifica; y si no se ha podido procesar por errores de validación, se informará de los
errores encontrados.
El fichero XML a enviar en una petición del tipo consulta de lotes se validará contra un fichero XSD
con la siguiente estructura:
Figura 7. Fichero XSD para la consulta de peticiones
3.1.1.6 Anular comunicaciones
➢ Tipo de operación: B
➢ Tipo de comunicación: PV, RH, AV, RV
La operación de anular permite anular una o varias comunicaciones. Se debe informar en el mensaje
de petición de los códigos de las comunicaciones a anular.
Se limitará el número de comunicaciones que se pueden anular en una petición del servicio.
Figura 8. Fichero XSD para la anulación de comunicaciones
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 34 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.1.1.5 Consulta de lotes
➢ Tipo de operación: C
El sistema permite la consulta de una o varias peticiones de alta previamente enviadas. Para ello se
deberá informar de los números de lotes devueltos por el servicio en el mensaje de respuesta de
cada una de ellas. El número de lotes máximo a consultar por operación será de 10.
Para cada petición, el servicio informará de su estado: si ha sido procesado, devolverá información
de las comunicaciones enviadas y su estado, si han sido procesadas correctamente, se enviará el
código que la identifica; y si no se ha podido procesar por errores de validación, se informará de los
errores encontrados.
El fichero XML a enviar en una petición del tipo consulta de lotes se validará contra un fichero XSD
con la siguiente estructura:
Figura 7. Fichero XSD para la consulta de peticiones
3.1.1.6 Anular comunicaciones
➢ Tipo de operación: B
➢ Tipo de comunicación: PV, RH, AV, RV
La operación de anular permite anular una o varias comunicaciones. Se debe informar en el mensaje
de petición de los códigos de las comunicaciones a anular.
Se limitará el número de comunicaciones que se pueden anular en una petición del servicio.
Figura 8. Fichero XSD para la anulación de comunicaciones
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 35 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.1.2. Respuesta
A continuación se recoge el esquema de validación del mensaje de respuesta que devuelve el
servicio tras una petición de cualquiera de las operaciones de alta, consulta o anulación.
Figura 9. Mensaje de respuesta de la operación comunicacion
La respuesta está formada por un bloque de infromación respuesta, que contendrá el código de
respuesta, una descripción informativa del código de respuesta y un número de lote creado por el
servicio.
• Si la petición es correcta, el mensaje de respuesta devolverá un código 0 y descripción ok.
• Si la petición no es correcta porque los datos enviados en la cabecera incluyen alguna
información no válida, se devolverá el código correspondiente al error y una descripción del
mismo.
El bloque de respuesta incluirá además un bloque resultado solo cuando la operación enviada es
de consulta. En este bloque se informará de los datos de cada una de los lotes a consultar.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 35 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.1.2. Respuesta
A continuación se recoge el esquema de validación del mensaje de respuesta que devuelve el
servicio tras una petición de cualquiera de las operaciones de alta, consulta o anulación.
Figura 9. Mensaje de respuesta de la operación comunicacion
La respuesta está formada por un bloque de infromación respuesta, que contendrá el código de
respuesta, una descripción informativa del código de respuesta y un número de lote creado por el
servicio.
• Si la petición es correcta, el mensaje de respuesta devolverá un código 0 y descripción ok.
• Si la petición no es correcta porque los datos enviados en la cabecera incluyen alguna
información no válida, se devolverá el código correspondiente al error y una descripción del
mismo.
El bloque de respuesta incluirá además un bloque resultado solo cuando la operación enviada es
de consulta. En este bloque se informará de los datos de cada una de los lotes a consultar.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 36 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Figura 10. Mensaje de respuesta de la operación comunicación – bloque resultado
Si el tipo de operación del lote era alta de comunicaciones, se incluirá el bloque
resultadoComunicaciones, con información del resultado del procesamiento de todas las
comunicaciones incluidas en el mismo, en el mismo orden en el que fueron enviadas:
• Si la comunicación se ha podido procesar correctamente, se informará del código asignado.
• Si la comunicación contenía errores de validación o información incorrecta, se informará de
los errores encontrados.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 36 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Figura 10. Mensaje de respuesta de la operación comunicación – bloque resultado
Si el tipo de operación del lote era alta de comunicaciones, se incluirá el bloque
resultadoComunicaciones, con información del resultado del procesamiento de todas las
comunicaciones incluidas en el mismo, en el mismo orden en el que fueron enviadas:
• Si la comunicación se ha podido procesar correctamente, se informará del código asignado.
• Si la comunicación contenía errores de validación o información incorrecta, se informará de
los errores encontrados.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 37 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Figura 11. Mensaje de respuesta de la operación comunicación – bloque resultadoComunicaciones
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del mensaje de respuesta.
Ubicación Nombre
parámetro
Tipo Obligatorio Descripción
comunicacionResponse respuesta BLOQUE Si Bloque único.
Contiene los datos de control que
informan del resultado de la
operación solciitada en el mensaje
de petición.
comunicacionResponse /
respuesta
codigo Numérico Si Código de respuesta de la petición.
Si la petición se ha tramitado
correctamente, contendrá el valor 0.
En el caso de que el mensaje de
petición contenga algún error y no se
haya podido tramitar, contendrá un
código identificativo del error.
Véase apartado 5. Códigos de error
devueltos por el servicio con los
códigos de respueta en caso de
error.
comunicacionResponse /
respuesta
descripcion String(100) Si Descripción del código de respuesta
de la petición.
En caso de error en la petición
contendrá un literal descriptivo del
error encontrado.
comunicacionResponse /
respuesta
lote String(36) No Identificador único generado por el
sistema en el momento de recibir el
mensaje de petición.
comunicacionResponse resultado BLOQUE No Bloque que se repite 0 a n veces.
Se incluye este bloque solo cuando
la operación es de consulta.
Contiene información de detalle de
cada uno de los lotes a consultar.
comunicacionResponse /
resultado
lote String(36) Si Identificador del lote.
comunicacionResponse /
resultado
tipoComunicacion String(2) Si Tipo de comunicaciones enviadas.
Valores:
• PV – partes de viajeros
• AV – alquieres de vehículos
• RH – reservas de hospedaje
• RV – reservas de vehículos de
alquiler
comunicacionResponse /
resultado
tipoOperacion String(1) Si Tipo de operación solicitado en el
lote.
Valores:
• A – alta
• C – consulta
• B – anulación
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 37 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Figura 11. Mensaje de respuesta de la operación comunicación – bloque resultadoComunicaciones
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del mensaje de respuesta.
Ubicación Nombre
parámetro
Tipo Obligatorio Descripción
comunicacionResponse respuesta BLOQUE Si Bloque único.
Contiene los datos de control que
informan del resultado de la
operación solciitada en el mensaje
de petición.
comunicacionResponse /
respuesta
codigo Numérico Si Código de respuesta de la petición.
Si la petición se ha tramitado
correctamente, contendrá el valor 0.
En el caso de que el mensaje de
petición contenga algún error y no se
haya podido tramitar, contendrá un
código identificativo del error.
Véase apartado 5. Códigos de error
devueltos por el servicio con los
códigos de respueta en caso de
error.
comunicacionResponse /
respuesta
descripcion String(100) Si Descripción del código de respuesta
de la petición.
En caso de error en la petición
contendrá un literal descriptivo del
error encontrado.
comunicacionResponse /
respuesta
lote String(36) No Identificador único generado por el
sistema en el momento de recibir el
mensaje de petición.
comunicacionResponse resultado BLOQUE No Bloque que se repite 0 a n veces.
Se incluye este bloque solo cuando
la operación es de consulta.
Contiene información de detalle de
cada uno de los lotes a consultar.
comunicacionResponse /
resultado
lote String(36) Si Identificador del lote.
comunicacionResponse /
resultado
tipoComunicacion String(2) Si Tipo de comunicaciones enviadas.
Valores:
• PV – partes de viajeros
• AV – alquieres de vehículos
• RH – reservas de hospedaje
• RV – reservas de vehículos de
alquiler
comunicacionResponse /
resultado
tipoOperacion String(1) Si Tipo de operación solicitado en el
lote.
Valores:
• A – alta
• C – consulta
• B – anulación
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 38 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
comunicacionResponse /
resultado
fechaPeticion Fecha Si Fecha en la que se recibió la
petición.
Formato AAAA-MM-DD hh:mm:ss
comunicacionResponse /
resultado
fechaProcesamie
nto
Fecha Si Fecha en la que fue procesada.
Formato AAAA-MM-DD hh:mm:ss
comunicacionResponse /
resultado
codigoEstado Numérico Si Estado del lote. Valores:
1 – Lote tramitado sin errores
2 – Lote con errores en la cabecera
o formato de la solicitud
3 – Error inesperado
4 – En proceso
5 – Pendiente
6 – Lote tramitado con errores en
algunas comunicaciones
comunicacionResponse /
resultado
descEstado String(200) Si Descripción del estado.
comunicacionResponse /
resultado
identificadorUsuar
io
String(50) Si Identificador del usuario que lanzó la
petición.
comunicacionResponse /
resultado
nombreUsuario String (150) Si Nombre y apellidos del usuario que
lanzó la petición
comunicacionResponse /
resultado
codigoArrendador String(10) Si Código del arrendador.
Contiene el mismo valor que el
enviado en el mensaje de petición.
comunicacionResponse /
resultado
aplicación String(50) Si Nombre del aplicativo cliente que
lanza la petición.
Contiene el mismo valor que el
enviado en el mensaje de petición.
comunicacionResponse /
resultado
resultadoComunic
aciones
BLOQUE No Bloque único.
Contiene información de cada una
de las comunicaciones incluídas en
bla petición.
Se incluye un bloque de este tipo
cuando el lote era de una operación
de alta de comunicaciones y se
pudieron procesar.
comunicacionResponse /
resultado /
resultadoComunicaciones
resultadoComunic
acion
BLOQUE No Bloque que se repite 0 a n veces.
Contiene la información de una
comunicación.
comunicacionResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
orden Numérico Si Posición de la comunicación en la
petición (si fue la primera
comunicación tendrá el valor 1, si fue
la segunda el 2, y así
sucesivamente)
comunicacionResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
anulada Booleano No Se añade esta etiqueta cuando la
comunicación ha sido anulada.
comunicacionResponse /
resultado /
codigoComunicac
ion
String(36) Obligatorio
incluir el
codigoComu
Identificador de la petición.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 38 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
comunicacionResponse /
resultado
fechaPeticion Fecha Si Fecha en la que se recibió la
petición.
Formato AAAA-MM-DD hh:mm:ss
comunicacionResponse /
resultado
fechaProcesamie
nto
Fecha Si Fecha en la que fue procesada.
Formato AAAA-MM-DD hh:mm:ss
comunicacionResponse /
resultado
codigoEstado Numérico Si Estado del lote. Valores:
1 – Lote tramitado sin errores
2 – Lote con errores en la cabecera
o formato de la solicitud
3 – Error inesperado
4 – En proceso
5 – Pendiente
6 – Lote tramitado con errores en
algunas comunicaciones
comunicacionResponse /
resultado
descEstado String(200) Si Descripción del estado.
comunicacionResponse /
resultado
identificadorUsuar
io
String(50) Si Identificador del usuario que lanzó la
petición.
comunicacionResponse /
resultado
nombreUsuario String (150) Si Nombre y apellidos del usuario que
lanzó la petición
comunicacionResponse /
resultado
codigoArrendador String(10) Si Código del arrendador.
Contiene el mismo valor que el
enviado en el mensaje de petición.
comunicacionResponse /
resultado
aplicación String(50) Si Nombre del aplicativo cliente que
lanza la petición.
Contiene el mismo valor que el
enviado en el mensaje de petición.
comunicacionResponse /
resultado
resultadoComunic
aciones
BLOQUE No Bloque único.
Contiene información de cada una
de las comunicaciones incluídas en
bla petición.
Se incluye un bloque de este tipo
cuando el lote era de una operación
de alta de comunicaciones y se
pudieron procesar.
comunicacionResponse /
resultado /
resultadoComunicaciones
resultadoComunic
acion
BLOQUE No Bloque que se repite 0 a n veces.
Contiene la información de una
comunicación.
comunicacionResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
orden Numérico Si Posición de la comunicación en la
petición (si fue la primera
comunicación tendrá el valor 1, si fue
la segunda el 2, y así
sucesivamente)
comunicacionResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
anulada Booleano No Se añade esta etiqueta cuando la
comunicación ha sido anulada.
comunicacionResponse /
resultado /
codigoComunicac
ion
String(36) Obligatorio
incluir el
codigoComu
Identificador de la petición.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 39 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
resultadoComunicaciones /
resultadoComunicacion
nicacion o el
tipoError y
error
Se incluye este dato si la
comunicación se procesó
correctamente.
comunicacionResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
tipoError String(5) Obligatorio
incluir el
codigoComu
nicacion o el
tipoError y
error
Identificador del error.
Se incluye este dato cuando la
comunicación no se pudo procesar
por algún error de validación.
comunicacionResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
error String(100) Obligatorio
incluir el
codigoComu
nicacion o el
tipoError y
error
Descripción del error.
Se incluye este dato cuando la
comunicación no se pudo procesar
por algún error de validación.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 39 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
resultadoComunicaciones /
resultadoComunicacion
nicacion o el
tipoError y
error
Se incluye este dato si la
comunicación se procesó
correctamente.
comunicacionResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
tipoError String(5) Obligatorio
incluir el
codigoComu
nicacion o el
tipoError y
error
Identificador del error.
Se incluye este dato cuando la
comunicación no se pudo procesar
por algún error de validación.
comunicacionResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
error String(100) Obligatorio
incluir el
codigoComu
nicacion o el
tipoError y
error
Descripción del error.
Se incluye este dato cuando la
comunicación no se pudo procesar
por algún error de validación.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 40 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.2. CONSULTA DE LOTES
Permite consultar la información de uno o varios lotes.
En el mensaje de petición se deberán especificar el o los códigos del lote a consultar. El mensaje
de respuesta contiene información del lote o lotes solicitados.
Si en el mensaje de petición se solicita información de algún lote que no existe, o que no pertenezca
a la entidad del usuario, el servicio no devolverá información de él.
El número máximo de lotes a consultar será de 10, sin embargo, este valor es un valor configurable
en el servicio, por lo que puede cambiar en un momento determinado si el administrador del sistema
así lo considera.
Operación → consultaLote
Figura 12. Mensajes para la operación consultaLote
3.2.1. Solicitud
A continuación se recoge el esquema de validación de la petición que debe recibir el Servicio de
Comunicación para la operación de consulta de un lote.
Figura 13. Mensaje de petición de la operación consultaLote
Ubicación Nombre parámetro Tipo Obligatorio Descripción
consultaLoteRequest codigosLote BLOQUE Si Bloque único.
Contiene los códigos de lote a
consultar.
consultaLoteRequest /
lote
lote String/36) Si Contiene un código de lote a
consultar.
Esta etiqueta se puede repetir
varias veces para la consulta de
varios lotes en una petición.
Cliente Servicio de
Comunicación
consultaLoteRequest
consultaLoteResponse
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 40 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.2. CONSULTA DE LOTES
Permite consultar la información de uno o varios lotes.
En el mensaje de petición se deberán especificar el o los códigos del lote a consultar. El mensaje
de respuesta contiene información del lote o lotes solicitados.
Si en el mensaje de petición se solicita información de algún lote que no existe, o que no pertenezca
a la entidad del usuario, el servicio no devolverá información de él.
El número máximo de lotes a consultar será de 10, sin embargo, este valor es un valor configurable
en el servicio, por lo que puede cambiar en un momento determinado si el administrador del sistema
así lo considera.
Operación → consultaLote
Figura 12. Mensajes para la operación consultaLote
3.2.1. Solicitud
A continuación se recoge el esquema de validación de la petición que debe recibir el Servicio de
Comunicación para la operación de consulta de un lote.
Figura 13. Mensaje de petición de la operación consultaLote
Ubicación Nombre parámetro Tipo Obligatorio Descripción
consultaLoteRequest codigosLote BLOQUE Si Bloque único.
Contiene los códigos de lote a
consultar.
consultaLoteRequest /
lote
lote String/36) Si Contiene un código de lote a
consultar.
Esta etiqueta se puede repetir
varias veces para la consulta de
varios lotes en una petición.
Cliente Servicio de
Comunicación
consultaLoteRequest
consultaLoteResponse
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 41 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.2.2. Respuesta
A continuación se recoge el esquema de validación del mensaje de respuesta que devuelve el
servicio tras una petición a la operación de consulta de lotes.
Figura 14. Mensaje de respuesta de la operación consultaLote
La respuesta está formada por un bloque de infromación respuesta, que contendrá el código de
respuesta y una descripción informativa del código de respuesta. Además, devolverá un bloque
resultado con la información de cada uno de los lotes solicitados.
El servicio únicamente devolverá información de los lotes solicitados cuando existan y pertenezcan
a una de las entidades del usuario.
El número máximo de lotes a
consultar es de 10, pero este valor
es configurable por lo que puede
cambiar en un futuro.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 41 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.2.2. Respuesta
A continuación se recoge el esquema de validación del mensaje de respuesta que devuelve el
servicio tras una petición a la operación de consulta de lotes.
Figura 14. Mensaje de respuesta de la operación consultaLote
La respuesta está formada por un bloque de infromación respuesta, que contendrá el código de
respuesta y una descripción informativa del código de respuesta. Además, devolverá un bloque
resultado con la información de cada uno de los lotes solicitados.
El servicio únicamente devolverá información de los lotes solicitados cuando existan y pertenezcan
a una de las entidades del usuario.
El número máximo de lotes a
consultar es de 10, pero este valor
es configurable por lo que puede
cambiar en un futuro.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 42 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Si el tipo de operación del lote era alta de comunicaciones, se incluirá el bloque
resultadoComunicaciones, con información del resultado del procesamiento de todas las
comunicaciones incluidas en el mismo, en el mismo orden en el que fueron enviadas:
• Si la comunicación se pudo procesar correctamente, se informará del código asignado.
• Si la comunicación contenía errores de validación o información incorrecta, se informará de
los errores encontrados.
Figura 15. Mensaje de respuesta de la operación consultaLote – bloque resultadoComunicaciones
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del mensaje de respuesta.
Ubicación Nombre
parámetro
Tipo Obligatorio Descripción
consultaLoteResponse respuesta BLOQUE Si Bloque único.
Contiene los datos de control que
informan del resultado de la
operación solciitada en el mensaje
de petición.
consultaLoteResponse /
respuesta
codigo Numérico Si Código de respuesta de la petición.
Si la petición se ha tramitado
correctamente, contendrá el valor 0.
Véase apartado 5. Códigos de error
devueltos por el servicio con los
códigos de respueta en caso de
error.
consultaLoteResponse /
respuesta
descripcion String(100) Si Descripción del código de respuesta
de la petición.
En caso de error en la petición
contendrá un literal descriptivo del
error encontrado.
consultaLoteResponse resultado BLOQUE No Bloque que se repite 0 a n veces.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 42 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Si el tipo de operación del lote era alta de comunicaciones, se incluirá el bloque
resultadoComunicaciones, con información del resultado del procesamiento de todas las
comunicaciones incluidas en el mismo, en el mismo orden en el que fueron enviadas:
• Si la comunicación se pudo procesar correctamente, se informará del código asignado.
• Si la comunicación contenía errores de validación o información incorrecta, se informará de
los errores encontrados.
Figura 15. Mensaje de respuesta de la operación consultaLote – bloque resultadoComunicaciones
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del mensaje de respuesta.
Ubicación Nombre
parámetro
Tipo Obligatorio Descripción
consultaLoteResponse respuesta BLOQUE Si Bloque único.
Contiene los datos de control que
informan del resultado de la
operación solciitada en el mensaje
de petición.
consultaLoteResponse /
respuesta
codigo Numérico Si Código de respuesta de la petición.
Si la petición se ha tramitado
correctamente, contendrá el valor 0.
Véase apartado 5. Códigos de error
devueltos por el servicio con los
códigos de respueta en caso de
error.
consultaLoteResponse /
respuesta
descripcion String(100) Si Descripción del código de respuesta
de la petición.
En caso de error en la petición
contendrá un literal descriptivo del
error encontrado.
consultaLoteResponse resultado BLOQUE No Bloque que se repite 0 a n veces.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 43 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Contiene información de detalle de
cada uno de los lotes a consultar.
consultaLoteResponse /
resultado
lote String(36) Si Identificador del lote.
consultaLoteResponse /
resultado
tipoComunicacion String(2) Si Tipo de comunicaciones enviadas.
Valores:
• PV – partes de viajeros
• AV – alquieres de vehículos
• RH – reservas de hospedaje
• RV – reservas de vehículos de
alquiler
consultaLoteResponse /
resultado
tipoOperacion String(1) Si Tipo de operación solicitado en el
lote. Valores:
• A – alta
• C – consulta
• B – anulación
consultaLoteResponse /
resultado
fechaPeticion Fecha Si Fecha en la que se recibió la
petición.
Formato AAAA-MM-DD hh:mm:ss
consultaLoteResponse /
resultado
fechaProcesamie
nto
Fecha Si Fecha en la que fue procesada.
Formato AAAA-MM-DD hh:mm:ss
consultaLoteResponse /
resultado
codigoEstado Numérico Si Estado del lote. Valores:
1 – Lote tramitado sin errores
2 – Lote con errores en la cabecera
o formato de la solicitud
3 – Error inesperado
4 – En proceso
5 – Pendiente
6 – Lote tramitado con errores en
algunas comunicaciones
consultaLoteResponse /
resultado
descEstado String(200) Si Descripción del estado.
consultaLoteResponse /
resultado
identificadorUsuar
io
String(50) Si Identificador del usuario que lanzó la
petición.
consultaLoteResponse /
resultado
nombreUsuario String (150) Si Nombre y apellidos del usuario que
lanzó la petición
consultaLoteResponse /
resultado
codigoArrendador String(10) Si Código del arrendador.
Contiene el mismo valor que el
enviado en el mensaje de petición.
consultaLoteResponse /
resultado
aplicación String(50) Si Nombre del aplicativo cliente que
lanza la petición.
Contiene el mismo valor que el
enviado en el mensaje de petición.
consultaLoteResponse /
resultado
resultadoComunic
aciones
BLOQUE No Bloque único.
Contiene información de cada una
de las comunicaciones incluídas en
la petición.
Se incluye un bloque de este tipo
cuando el lote era de una operación
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 43 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Contiene información de detalle de
cada uno de los lotes a consultar.
consultaLoteResponse /
resultado
lote String(36) Si Identificador del lote.
consultaLoteResponse /
resultado
tipoComunicacion String(2) Si Tipo de comunicaciones enviadas.
Valores:
• PV – partes de viajeros
• AV – alquieres de vehículos
• RH – reservas de hospedaje
• RV – reservas de vehículos de
alquiler
consultaLoteResponse /
resultado
tipoOperacion String(1) Si Tipo de operación solicitado en el
lote. Valores:
• A – alta
• C – consulta
• B – anulación
consultaLoteResponse /
resultado
fechaPeticion Fecha Si Fecha en la que se recibió la
petición.
Formato AAAA-MM-DD hh:mm:ss
consultaLoteResponse /
resultado
fechaProcesamie
nto
Fecha Si Fecha en la que fue procesada.
Formato AAAA-MM-DD hh:mm:ss
consultaLoteResponse /
resultado
codigoEstado Numérico Si Estado del lote. Valores:
1 – Lote tramitado sin errores
2 – Lote con errores en la cabecera
o formato de la solicitud
3 – Error inesperado
4 – En proceso
5 – Pendiente
6 – Lote tramitado con errores en
algunas comunicaciones
consultaLoteResponse /
resultado
descEstado String(200) Si Descripción del estado.
consultaLoteResponse /
resultado
identificadorUsuar
io
String(50) Si Identificador del usuario que lanzó la
petición.
consultaLoteResponse /
resultado
nombreUsuario String (150) Si Nombre y apellidos del usuario que
lanzó la petición
consultaLoteResponse /
resultado
codigoArrendador String(10) Si Código del arrendador.
Contiene el mismo valor que el
enviado en el mensaje de petición.
consultaLoteResponse /
resultado
aplicación String(50) Si Nombre del aplicativo cliente que
lanza la petición.
Contiene el mismo valor que el
enviado en el mensaje de petición.
consultaLoteResponse /
resultado
resultadoComunic
aciones
BLOQUE No Bloque único.
Contiene información de cada una
de las comunicaciones incluídas en
la petición.
Se incluye un bloque de este tipo
cuando el lote era de una operación
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 44 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
de alta de comunicaciones y se
pudieron procesar.
consultaLoteResponse /
resultado /
resultadoComunicaciones
resultadoComunic
acion
BLOQUE No Bloque que se repite 0 a n veces.
Contiene la información de una
comunicación.
consultaLoteResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
orden Numérico Si Posición de la comunicación en la
petición (si fue la primera
comunicación tendrá el valor 1, si fue
la segunda el 2, y así
sucesivamente)
consultaLoteResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
anulada Booleano No Indica que la comunicación ha sido
anulada.
consultaLoteResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
codigoComunicac
ion
String(36) Obligatorio
incluir el
codigoComu
nicacion o el
tipoError y
error
Identificador de la petición.
Se incluye este dato si la
comunicación se procesó
correctamente.
consultaLoteResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
tipoError String(5) Obligatorio
incluir el
codigoComu
nicacion o el
tipoError y
error
Identificador del error.
Se incluye este dato cuando la
comunicación no se pudo procesar
por algún error de validación.
consultaLoteResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
error String(100) Obligatorio
incluir el
codigoComu
nicacion o el
tipoError y
error
Descripción del error.
Se incluye este dato cuando la
comunicación no se pudo procesar
por algún error de validación.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 44 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
de alta de comunicaciones y se
pudieron procesar.
consultaLoteResponse /
resultado /
resultadoComunicaciones
resultadoComunic
acion
BLOQUE No Bloque que se repite 0 a n veces.
Contiene la información de una
comunicación.
consultaLoteResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
orden Numérico Si Posición de la comunicación en la
petición (si fue la primera
comunicación tendrá el valor 1, si fue
la segunda el 2, y así
sucesivamente)
consultaLoteResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
anulada Booleano No Indica que la comunicación ha sido
anulada.
consultaLoteResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
codigoComunicac
ion
String(36) Obligatorio
incluir el
codigoComu
nicacion o el
tipoError y
error
Identificador de la petición.
Se incluye este dato si la
comunicación se procesó
correctamente.
consultaLoteResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
tipoError String(5) Obligatorio
incluir el
codigoComu
nicacion o el
tipoError y
error
Identificador del error.
Se incluye este dato cuando la
comunicación no se pudo procesar
por algún error de validación.
consultaLoteResponse /
resultado /
resultadoComunicaciones /
resultadoComunicacion
error String(100) Obligatorio
incluir el
codigoComu
nicacion o el
tipoError y
error
Descripción del error.
Se incluye este dato cuando la
comunicación no se pudo procesar
por algún error de validación.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 45 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3. CONSULTA DE COMUNICACIONES
Permite consultar la información de una o varias comunicaciones.
En el mensaje de petición se deberán especificar los códigos de comunicación a consultar.
En el mensaje de respuesta, el servicio devolverá información de las comunicaciones solicitadas.
Solo se informará de las comunicaciones que existan y que correspondan a la entidad del usuario,
es decir, si en el mensaje de petición se solicita información de una comunicación con un código
inexistente o de una comunicación que pertenezca a otra entidad, el sistema no enviará ninguna
información de ella.
El número máximo de comunicaciones a consultar será de 10, sin embargo, este valor es un valor
configurable en el servicio, por lo que puede cambiar en un momento determinado si el administrador
del sistema así lo considera.
Operación → consultaComunicacion
Figura 16. Mensajes para la operación consultaComunicacion
3.3.1. Solicitud
A continuación se recoge el esquema de validación de la petición que debe recibir el Servicio de
Comunicación para la operación de consultar comunicaciones.
Figura 17. Mensaje de petición de la operación consultaComunicacion
Ubicación Nombre parámetro Tipo Obligatorio Descripción
consultaComunicacion
Request
codigos BLOQUE Si Bloque único.
Contiene los códigos de
comunicación a consultar.
consultaComunicacion
Request / codigos
codigo String/36) Si Contiene un código de
comunicación a consultar.
Esta etiqueta se puede repetir
varias veces para la consulta de
Cliente Servicio de
Comunicación
consultaComunicacionRequest
consultaComunicacionResponse
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 45 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3. CONSULTA DE COMUNICACIONES
Permite consultar la información de una o varias comunicaciones.
En el mensaje de petición se deberán especificar los códigos de comunicación a consultar.
En el mensaje de respuesta, el servicio devolverá información de las comunicaciones solicitadas.
Solo se informará de las comunicaciones que existan y que correspondan a la entidad del usuario,
es decir, si en el mensaje de petición se solicita información de una comunicación con un código
inexistente o de una comunicación que pertenezca a otra entidad, el sistema no enviará ninguna
información de ella.
El número máximo de comunicaciones a consultar será de 10, sin embargo, este valor es un valor
configurable en el servicio, por lo que puede cambiar en un momento determinado si el administrador
del sistema así lo considera.
Operación → consultaComunicacion
Figura 16. Mensajes para la operación consultaComunicacion
3.3.1. Solicitud
A continuación se recoge el esquema de validación de la petición que debe recibir el Servicio de
Comunicación para la operación de consultar comunicaciones.
Figura 17. Mensaje de petición de la operación consultaComunicacion
Ubicación Nombre parámetro Tipo Obligatorio Descripción
consultaComunicacion
Request
codigos BLOQUE Si Bloque único.
Contiene los códigos de
comunicación a consultar.
consultaComunicacion
Request / codigos
codigo String/36) Si Contiene un código de
comunicación a consultar.
Esta etiqueta se puede repetir
varias veces para la consulta de
Cliente Servicio de
Comunicación
consultaComunicacionRequest
consultaComunicacionResponse
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 46 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2. Respuesta
A continuación se recoge el esquema de validación del mensaje de respuesta que devuelve el
servicio tras una petición a la operación de consulta de comunicaciones.
varias comunicaciones en una
petición.
El número máximo de
comunicaciones a consultar es de
10, pero este valor es configurable
por lo que puede cambiar en un
futuro.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 46 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2. Respuesta
A continuación se recoge el esquema de validación del mensaje de respuesta que devuelve el
servicio tras una petición a la operación de consulta de comunicaciones.
varias comunicaciones en una
petición.
El número máximo de
comunicaciones a consultar es de
10, pero este valor es configurable
por lo que puede cambiar en un
futuro.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 47 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Figura 18. Mensaje de respuesta de la operación consultaComunicacion
Dependiendo del tipo de comunicación - reservas de hospedaje, reservas de vehículos o
formalizaciones de contratos de hospedaje (parte de viajeros) o de alquiler de vehículo - la respuesta
contendrá el bloque de de información correspondiente.
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del mensaje de respuesta.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 47 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Figura 18. Mensaje de respuesta de la operación consultaComunicacion
Dependiendo del tipo de comunicación - reservas de hospedaje, reservas de vehículos o
formalizaciones de contratos de hospedaje (parte de viajeros) o de alquiler de vehículo - la respuesta
contendrá el bloque de de información correspondiente.
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del mensaje de respuesta.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 48 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Ubicación Nombre parámetro Tipo Obligatorio Descripción
consultaComunicacio
nResponse
resultado BLOQUE Si Bloque único.
Contiene los datos de control que
informan del resultado de la
operación solciitada en el mensaje
de petición.
consultaComunicacio
nResponse /
resultado
codigo Numérico Si Código de respuesta de la petición.
Si la petición se ha tramitado
correctamente, contendrá el valor
0.
Véase apartado 5. 5. Códigos de
error devueltos por el servicio con
los códigos de respueta en caso de
error.
consultaComunicacio
nResponse /
resultado
descripcion String(100) Si Descripción del código de
respuesta de la petición.
En caso de error en la petición
contendrá un literal descriptivo del
error encontrado.
consultaComunicacion
Response
comunicacion BLOQUE No Bloque que se repite de 0 a n veces.
Contiene la información de una
comunicación.
consultaComunicacion
Response /
comunicacion
tipo String(2) Si Indica el tipo de comunicación.
Valores:
• PV - Parte de viajeros
• AV - Alquiler de vehículo
• RH - Reserva de hospedaje
• RV - Reserva de vehículo
consultaComunicacion
Response /
comunicación
codigo String(36) Si Código de la comunicación
consultaComunicacion
Response /
comunicación
anulada Booleano No Indica que la comunicación ha sido
anulada.
Se incluye esta etiqueta únicamente
en las comunicaciones anuladas.
consultaComunicacion
Response /
comunicación
referencia String(50) Si Número de referencia del contrato.
consultaComunicacion
Response /
comunicación
fechaContrato Fecha Si Fecha en la que se formalizó el
contrato o se efectuó la reserva.
consultaComunicacion
Response /
comunicación
fechaInicio Fecha Si Fecha de entrada en el
establecimiento (para los tipos de
comunicación de partes de viajeros o
reservas de hospedaje) o fecha de
recogida del vehículo (para los
partes de reserva o alquiler de
vehículos).
consultaComunicacion
Response /
comunicación
fechaFin Fecha Si Fecha de salida del establecimiento
(para los tipos de comunicación de
partes de viajeros o reservas de
hospedaje) o fecha de devolución del
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 48 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Ubicación Nombre parámetro Tipo Obligatorio Descripción
consultaComunicacio
nResponse
resultado BLOQUE Si Bloque único.
Contiene los datos de control que
informan del resultado de la
operación solciitada en el mensaje
de petición.
consultaComunicacio
nResponse /
resultado
codigo Numérico Si Código de respuesta de la petición.
Si la petición se ha tramitado
correctamente, contendrá el valor
0.
Véase apartado 5. 5. Códigos de
error devueltos por el servicio con
los códigos de respueta en caso de
error.
consultaComunicacio
nResponse /
resultado
descripcion String(100) Si Descripción del código de
respuesta de la petición.
En caso de error en la petición
contendrá un literal descriptivo del
error encontrado.
consultaComunicacion
Response
comunicacion BLOQUE No Bloque que se repite de 0 a n veces.
Contiene la información de una
comunicación.
consultaComunicacion
Response /
comunicacion
tipo String(2) Si Indica el tipo de comunicación.
Valores:
• PV - Parte de viajeros
• AV - Alquiler de vehículo
• RH - Reserva de hospedaje
• RV - Reserva de vehículo
consultaComunicacion
Response /
comunicación
codigo String(36) Si Código de la comunicación
consultaComunicacion
Response /
comunicación
anulada Booleano No Indica que la comunicación ha sido
anulada.
Se incluye esta etiqueta únicamente
en las comunicaciones anuladas.
consultaComunicacion
Response /
comunicación
referencia String(50) Si Número de referencia del contrato.
consultaComunicacion
Response /
comunicación
fechaContrato Fecha Si Fecha en la que se formalizó el
contrato o se efectuó la reserva.
consultaComunicacion
Response /
comunicación
fechaInicio Fecha Si Fecha de entrada en el
establecimiento (para los tipos de
comunicación de partes de viajeros o
reservas de hospedaje) o fecha de
recogida del vehículo (para los
partes de reserva o alquiler de
vehículos).
consultaComunicacion
Response /
comunicación
fechaFin Fecha Si Fecha de salida del establecimiento
(para los tipos de comunicación de
partes de viajeros o reservas de
hospedaje) o fecha de devolución del
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 49 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
vehículo (para los partes de reserva
o alquiler de vehículos).
consultaComunicacion
Response /
comunicación
fechaAlta Fecha Si Fecha de envío de la comunicación.
consultaComunicacion
Response /
comunicación
pago BLOQUE Si Bloque único.
Contiene la información del pago.
Su contenido está descrito en el
apartado 3.3.2.1. Formato de bloques
comunes.
consultaComunicacion
Response /
comunicación
arrendador BLOQUE Si Bloque único.
Contiene la información de la entidad
donde se ha realizado la reserva o
propietaria del establecimiento.
Su contenido está descrito en el
apartado 3.3.2.2. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
establecimiento BLOQUE Obligatorio si el
tipo de
comunicación
es parte de
viajeros o
reserva de
hospedaje
Bloque único
Contiene los datos del
establecimiento donde se ha
efectuado la reserva o parte de
viajeros.
Su contenido está descrito en el
apartado 3.3.2.3. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
infoAlojamiento BLOQUE Obligatorio si el
tipo de
comunicación
es parte de
viajeros o
reserva de
hospedaje
Bloque único.
Contiene la información del contrato
o reserva de hospedaje.
Su contenido está descrito en el
apartado 3.3.2.5. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
direccionRecogida BLOQUE Si el tipo de
comunicación
es reserva o
alquiler de
vehículo, se
incluye esta
etiqueta si en la
comunicación
se indicó una
dirección de
recogida.
Bloque único.
Contiene la información de la
dirección de recogida del vehículo,
cuando el tipo de comunicación es
una reserva o alquiler del vehículo.
Su contenido está descrito en el
apartado 3.3.2.4. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
direccionDevolucion BLOQUE Si el tipo de
comunicación
es reserva o
alquiler de
vehículo, se
incluye esta
etiqueta si en la
comunicación
se indicó una
dirección de
devolución.
Bloque único.
Contiene la información de la
dirección de devolución del vehículo,
cuando el tipo de comunicación es
una reserva o alquiler del vehículo.
Su contenido está descrito en el
apartado 3.3.2.4. Formato de
bloques comunes.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 49 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
vehículo (para los partes de reserva
o alquiler de vehículos).
consultaComunicacion
Response /
comunicación
fechaAlta Fecha Si Fecha de envío de la comunicación.
consultaComunicacion
Response /
comunicación
pago BLOQUE Si Bloque único.
Contiene la información del pago.
Su contenido está descrito en el
apartado 3.3.2.1. Formato de bloques
comunes.
consultaComunicacion
Response /
comunicación
arrendador BLOQUE Si Bloque único.
Contiene la información de la entidad
donde se ha realizado la reserva o
propietaria del establecimiento.
Su contenido está descrito en el
apartado 3.3.2.2. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
establecimiento BLOQUE Obligatorio si el
tipo de
comunicación
es parte de
viajeros o
reserva de
hospedaje
Bloque único
Contiene los datos del
establecimiento donde se ha
efectuado la reserva o parte de
viajeros.
Su contenido está descrito en el
apartado 3.3.2.3. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
infoAlojamiento BLOQUE Obligatorio si el
tipo de
comunicación
es parte de
viajeros o
reserva de
hospedaje
Bloque único.
Contiene la información del contrato
o reserva de hospedaje.
Su contenido está descrito en el
apartado 3.3.2.5. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
direccionRecogida BLOQUE Si el tipo de
comunicación
es reserva o
alquiler de
vehículo, se
incluye esta
etiqueta si en la
comunicación
se indicó una
dirección de
recogida.
Bloque único.
Contiene la información de la
dirección de recogida del vehículo,
cuando el tipo de comunicación es
una reserva o alquiler del vehículo.
Su contenido está descrito en el
apartado 3.3.2.4. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
direccionDevolucion BLOQUE Si el tipo de
comunicación
es reserva o
alquiler de
vehículo, se
incluye esta
etiqueta si en la
comunicación
se indicó una
dirección de
devolución.
Bloque único.
Contiene la información de la
dirección de devolución del vehículo,
cuando el tipo de comunicación es
una reserva o alquiler del vehículo.
Su contenido está descrito en el
apartado 3.3.2.4. Formato de
bloques comunes.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 50 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
consultaComunicacion
Response /
comunicación
establecimientoRecogida BLOQUE Si el tipo de
comunicación
es reserva o
alquiler de
vehículo, se
incluye esta
etiqueta si en la
comunicación
se indicó un
establecimiento
de recogida.
Bloque único.
Contiene la información del
establecimiento donde se recoge o
recogerá el vehículo, cuando el tipo
de comunicación es una reserva o
alquiler del vehículo.
Su contenido está descrito en el
apartado 3.3.2.3. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
establecimientoDevolucio
n
BLOQUE Si el tipo de
comunicación
es reserva o
alquiler de
vehículo, se
incluye esta
etiqueta si en la
comunicación
se indicó un
establecimiento
de devolución.
Bloque único.
Contiene la información del
establecimiento donde se devolverá
el vehículo, cuando el tipo de
comunicación es una reserva o
alquiler del vehículo.
Su contenido está descrito en el
apartado 3.3.2.3. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
personas BLOQUE Si Bloque único.
Contiene información sobre las
personas incluidas en la reserva o
contrato.
consultaComunicacion
Response /
comunicación /
personas
persona BLOQUE No Blque que se repite de 0 a n veces.
Contiene información sobre una
persona incluida en la reserva o
contrato.
Su contenido está descrito en el
apartado 3.3.2.6. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
vehiculos BLOQUE Obligatorio si la
comunicación
es del tipo
reserva o
alquiler de
vehículo
Bloque único.
Contiene los datos de los vehículos
reservados o alquilados.
consultaComunicacion
Response /
comunicación /
vehiculos
vehiculo BLOQUE Obligatorio si la
comunicación
es del tipo
reserva o
alquiler de
vehículo
Bloque que se repite de 0 a n veces.
Contiene la información del vehículo.
Su contenido está descrito en el
apartado 3.3.2.8. Formato de
bloques comunes.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 50 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
consultaComunicacion
Response /
comunicación
establecimientoRecogida BLOQUE Si el tipo de
comunicación
es reserva o
alquiler de
vehículo, se
incluye esta
etiqueta si en la
comunicación
se indicó un
establecimiento
de recogida.
Bloque único.
Contiene la información del
establecimiento donde se recoge o
recogerá el vehículo, cuando el tipo
de comunicación es una reserva o
alquiler del vehículo.
Su contenido está descrito en el
apartado 3.3.2.3. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
establecimientoDevolucio
n
BLOQUE Si el tipo de
comunicación
es reserva o
alquiler de
vehículo, se
incluye esta
etiqueta si en la
comunicación
se indicó un
establecimiento
de devolución.
Bloque único.
Contiene la información del
establecimiento donde se devolverá
el vehículo, cuando el tipo de
comunicación es una reserva o
alquiler del vehículo.
Su contenido está descrito en el
apartado 3.3.2.3. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
personas BLOQUE Si Bloque único.
Contiene información sobre las
personas incluidas en la reserva o
contrato.
consultaComunicacion
Response /
comunicación /
personas
persona BLOQUE No Blque que se repite de 0 a n veces.
Contiene información sobre una
persona incluida en la reserva o
contrato.
Su contenido está descrito en el
apartado 3.3.2.6. Formato de
bloques comunes.
consultaComunicacion
Response /
comunicación
vehiculos BLOQUE Obligatorio si la
comunicación
es del tipo
reserva o
alquiler de
vehículo
Bloque único.
Contiene los datos de los vehículos
reservados o alquilados.
consultaComunicacion
Response /
comunicación /
vehiculos
vehiculo BLOQUE Obligatorio si la
comunicación
es del tipo
reserva o
alquiler de
vehículo
Bloque que se repite de 0 a n veces.
Contiene la información del vehículo.
Su contenido está descrito en el
apartado 3.3.2.8. Formato de
bloques comunes.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 51 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.1 Formato del bloque pago
Figura 19. Mensaje de respuesta de la operación consultaComunicacion – bloque pago
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque pago.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
pago tipo String(50) Si Tipo de pago.
Para obtener los códigos de los tipos
de pago utilice la operación catalogo,
pasándole en la etiqueta ‘catalogo’ el
valor TIPO_PAGO.
pago fecha Fecha No Fecha en la que se realizó el pago.
pago medioPago String(50) No Medio de pago.
pago titular String(100) No Nombre del titular del pago
pago caducidadTarjeta String(7) No Fecha de caducidad de la tarjeta en el
caso de que le pago fuera por tarjeta.
Formato MM/AAAA
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 51 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.1 Formato del bloque pago
Figura 19. Mensaje de respuesta de la operación consultaComunicacion – bloque pago
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque pago.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
pago tipo String(50) Si Tipo de pago.
Para obtener los códigos de los tipos
de pago utilice la operación catalogo,
pasándole en la etiqueta ‘catalogo’ el
valor TIPO_PAGO.
pago fecha Fecha No Fecha en la que se realizó el pago.
pago medioPago String(50) No Medio de pago.
pago titular String(100) No Nombre del titular del pago
pago caducidadTarjeta String(7) No Fecha de caducidad de la tarjeta en el
caso de que le pago fuera por tarjeta.
Formato MM/AAAA
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 52 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.2 Formato del bloque arrendador
Figura 20. Mensaje de respuesta de la operación consultaComunicacion – bloque arrendador
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque arrendador.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
arrendador nombre String(100) Si Nombre de la empresa o de la persona
particular arrendadora.
arrendador apellido1 String(100) No Primer apellido de la persona
arrendadora, para los casos en los que
el arrendador es una persona física.
arrendador apellido2 String(100) No Segundo apellido de la persona
arrendadora, para los casos en los que
el arrendador es una persona física.
arrendador tipoDocumento String(5) Si Tipo de documento de identidad.
Para obtener los códigos de los tipos
de documento utilice la operación
catalogo, pasándole en la etiqueta
‘catalogo’ el valor
TIPO_DOCUMENTO.
arrendador documento String(15) Si NIF de la empresa o de la persona
particular arrendadora.
arrendador codigo String(10) Si Código del arrendador.
arrendador tipo String((5) Si Tipo de arrendador.
Valores:
• EH: hospedaje
• AV: alquiler de vehículos
• OT: operador turístico
• PD: plataforma digital
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 52 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.2 Formato del bloque arrendador
Figura 20. Mensaje de respuesta de la operación consultaComunicacion – bloque arrendador
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque arrendador.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
arrendador nombre String(100) Si Nombre de la empresa o de la persona
particular arrendadora.
arrendador apellido1 String(100) No Primer apellido de la persona
arrendadora, para los casos en los que
el arrendador es una persona física.
arrendador apellido2 String(100) No Segundo apellido de la persona
arrendadora, para los casos en los que
el arrendador es una persona física.
arrendador tipoDocumento String(5) Si Tipo de documento de identidad.
Para obtener los códigos de los tipos
de documento utilice la operación
catalogo, pasándole en la etiqueta
‘catalogo’ el valor
TIPO_DOCUMENTO.
arrendador documento String(15) Si NIF de la empresa o de la persona
particular arrendadora.
arrendador codigo String(10) Si Código del arrendador.
arrendador tipo String((5) Si Tipo de arrendador.
Valores:
• EH: hospedaje
• AV: alquiler de vehículos
• OT: operador turístico
• PD: plataforma digital
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 53 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.3 Formato del bloque establecimiento
Figura 21. Mensaje de respuesta de la operación consultaComunicacion – bloque establecimiento
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque establecimiento.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
establecimiento codigo String(10) No Código del establecimiento.
establecimiento nombre String(100) No Nombre del establecimiento.
establecimiento tipo String(100) No Código del tipo de establecimiento.
Para obtener los códigos de los tipos
de establecimiento utilice la operación
catalogo, pasándole en la etiqueta
‘catalogo’ el valor
TIPO_ESTABLECIMIENTO.
establecimiento direccion BLOQUE No Bloque único.
Contiene la dirección del
establecimiento.
Su contenido está descrito en el
apartado 3.3.2.4. Formato del bloque
direccion.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 53 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.3 Formato del bloque establecimiento
Figura 21. Mensaje de respuesta de la operación consultaComunicacion – bloque establecimiento
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque establecimiento.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
establecimiento codigo String(10) No Código del establecimiento.
establecimiento nombre String(100) No Nombre del establecimiento.
establecimiento tipo String(100) No Código del tipo de establecimiento.
Para obtener los códigos de los tipos
de establecimiento utilice la operación
catalogo, pasándole en la etiqueta
‘catalogo’ el valor
TIPO_ESTABLECIMIENTO.
establecimiento direccion BLOQUE No Bloque único.
Contiene la dirección del
establecimiento.
Su contenido está descrito en el
apartado 3.3.2.4. Formato del bloque
direccion.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 54 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.4 Formato del bloque direccion
Figura 22. Mensaje de respuesta de la operación consultaComunicacion – bloque direccion
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque dirección.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
direccion direccion String(100) Si Contiene el nombre de la vía, número,
piso, escalera y demás datos que
componen la dirección.
direccion direccionComplementaria String(100) No Contiene información extra de la
dirección.
direccion municipio String(5) Obligatorio si
el país es
España
Municipio.
Este campo irá codificado con los
códigos de municipios del INE (6
dígitos).
direccion localidad String(100) Obligatorio si
el país no es
España
Nombre de la localidad, municipio,
ciudad o estado.
direccion cp String(20) Si Código postal.
direccion pais String(3) Si Código del país.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 54 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.4 Formato del bloque direccion
Figura 22. Mensaje de respuesta de la operación consultaComunicacion – bloque direccion
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque dirección.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
direccion direccion String(100) Si Contiene el nombre de la vía, número,
piso, escalera y demás datos que
componen la dirección.
direccion direccionComplementaria String(100) No Contiene información extra de la
dirección.
direccion municipio String(5) Obligatorio si
el país es
España
Municipio.
Este campo irá codificado con los
códigos de municipios del INE (6
dígitos).
direccion localidad String(100) Obligatorio si
el país no es
España
Nombre de la localidad, municipio,
ciudad o estado.
direccion cp String(20) Si Código postal.
direccion pais String(3) Si Código del país.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 55 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.5 Formato del bloque infoAlojamiento
Figura 23. Mensaje de respuesta de la operación consultaComunicacion – bloque infoAlojamiento
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque infoAlojamiento.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
infoAlojamiento numeroPersonas Numérico No Número de personas que viajan juntas
y están incluidas en el contrato.
infoAlojamiento conexionInternet Booleano No Indica si el establecimiento tiene
conexión a internet o no.
infoAlojamiento numeroHabitaciones Numérico No Número de habitaciones reservadas u
ocupadas
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 55 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.5 Formato del bloque infoAlojamiento
Figura 23. Mensaje de respuesta de la operación consultaComunicacion – bloque infoAlojamiento
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque infoAlojamiento.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
infoAlojamiento numeroPersonas Numérico No Número de personas que viajan juntas
y están incluidas en el contrato.
infoAlojamiento conexionInternet Booleano No Indica si el establecimiento tiene
conexión a internet o no.
infoAlojamiento numeroHabitaciones Numérico No Número de habitaciones reservadas u
ocupadas
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 56 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.6 Formato del bloque persona
Figura 24. Mensaje de respuesta de la operación consultaComunicacion – bloque persona
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque persona.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
persona rol String(5) Si Indica el rol de la persona en la
reserva o contrato. Valores:
- VI: Viajero
- TI: Titular del contrato
- CP: Conductor principal
- CS: Conductor secundario
persona nombre String(50) Si Nombre de la persona.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 56 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.6 Formato del bloque persona
Figura 24. Mensaje de respuesta de la operación consultaComunicacion – bloque persona
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque persona.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
persona rol String(5) Si Indica el rol de la persona en la
reserva o contrato. Valores:
- VI: Viajero
- TI: Titular del contrato
- CP: Conductor principal
- CS: Conductor secundario
persona nombre String(50) Si Nombre de la persona.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 57 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
persona apellido1 String(50) Si Primer apellido de la persona.
persona apellido2 String(50) No Segundo apellido de la persona
persona tipoDocumento String(5) No Tipo de documento de identidad.
Para obtener los códigos de los tipos
de documento utilice la operación
catalogo, pasándole en la etiqueta
‘catalogo’ el valor
TIPO_DOCUMENTO.
persona documento String(15) No Número de documento de identidad de
la persona.
persona soporteDocumento String(9) No Número de soporte del documento de
identidad.
persona fechaNacimiento Fecha No Fecha de nacimiento.
persona nacionalidad String(70) No Nombre del país de nacionalidad de la
persona.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
persona sexo String(1) No Sexo de la persona.
Para obtener los códigos de sexo utilice
la operación catalogo, pasándole en la
etiqueta ‘catalogo’ el valor SEXO.
persona direccion BLOQUE No Bloque único.
Contiene la dirección del domicilio
particular de la persona.
Su contenido está descrito en el
apartado 3.3.2.4.Formato del bloque
direccion.
persona teléfono String(20) No Teléfono de contacto de la persona.
persona teléfono2 String(20) No Segundo teléfono de contacto.
persona correo String(250) No Email de contacto.
persona parentesco String(50) No Si alguna de las personas es menor de
edad, contiene la relación de
parentesco de la persona mayor de
edad con respecto a la menor (padre,
madre, abuelo/a, hermano/a,...)
persona permisoConducir BLOQUE No Bloque único.
Contiene los datos del permiso de
conducir de la persona.
Se incluirá este boque en las
comunicaciones del tipo reserva o
alquiler de vehículo, cuando se haya
enviado la información.
Su contenido está descrito en el
apartado 3.3.2.7.Formato del bloque
permisoConducir
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 57 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
persona apellido1 String(50) Si Primer apellido de la persona.
persona apellido2 String(50) No Segundo apellido de la persona
persona tipoDocumento String(5) No Tipo de documento de identidad.
Para obtener los códigos de los tipos
de documento utilice la operación
catalogo, pasándole en la etiqueta
‘catalogo’ el valor
TIPO_DOCUMENTO.
persona documento String(15) No Número de documento de identidad de
la persona.
persona soporteDocumento String(9) No Número de soporte del documento de
identidad.
persona fechaNacimiento Fecha No Fecha de nacimiento.
persona nacionalidad String(70) No Nombre del país de nacionalidad de la
persona.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
persona sexo String(1) No Sexo de la persona.
Para obtener los códigos de sexo utilice
la operación catalogo, pasándole en la
etiqueta ‘catalogo’ el valor SEXO.
persona direccion BLOQUE No Bloque único.
Contiene la dirección del domicilio
particular de la persona.
Su contenido está descrito en el
apartado 3.3.2.4.Formato del bloque
direccion.
persona teléfono String(20) No Teléfono de contacto de la persona.
persona teléfono2 String(20) No Segundo teléfono de contacto.
persona correo String(250) No Email de contacto.
persona parentesco String(50) No Si alguna de las personas es menor de
edad, contiene la relación de
parentesco de la persona mayor de
edad con respecto a la menor (padre,
madre, abuelo/a, hermano/a,...)
persona permisoConducir BLOQUE No Bloque único.
Contiene los datos del permiso de
conducir de la persona.
Se incluirá este boque en las
comunicaciones del tipo reserva o
alquiler de vehículo, cuando se haya
enviado la información.
Su contenido está descrito en el
apartado 3.3.2.7.Formato del bloque
permisoConducir
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 58 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.7 Formato del bloque permisoConducir
Figura 25. Mensaje de respuesta de la operación consultaComunicacion – bloque permisoConducir
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque permisoConducir.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
permisoConducir tipo String(5) Si Tipo de permiso de conducir.
Para obtener los códigos de los tipos
de documento utilice la operación
catalogo, pasándole en la etiqueta
‘catalogo’ el valor
TIPO_PERMISO_CONDUCIR.
permisoConducir fechaValidez Fecha No Fecha de validez del permiso.
permisoConducir numero String(25) No Número de permiso de conducir.
permisoConducir soporte String(25) No Número de soporte del permiso.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 58 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.7 Formato del bloque permisoConducir
Figura 25. Mensaje de respuesta de la operación consultaComunicacion – bloque permisoConducir
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque permisoConducir.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
permisoConducir tipo String(5) Si Tipo de permiso de conducir.
Para obtener los códigos de los tipos
de documento utilice la operación
catalogo, pasándole en la etiqueta
‘catalogo’ el valor
TIPO_PERMISO_CONDUCIR.
permisoConducir fechaValidez Fecha No Fecha de validez del permiso.
permisoConducir numero String(25) No Número de permiso de conducir.
permisoConducir soporte String(25) No Número de soporte del permiso.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 59 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.8 Formato del bloque vehiculo
Figura 26. Mensaje de respuesta de la operación consultaComunicacion – bloque vehiculo
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque vehiculo.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 59 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.3.2.8 Formato del bloque vehiculo
Figura 26. Mensaje de respuesta de la operación consultaComunicacion – bloque vehiculo
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del bloque vehiculo.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 60 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Ubicación Nombre parámetro Tipo Obligatorio Descripción
vehiculo tipo String(50) No Tipo de vehículo.
Para obtener los códigos de los tipos
de vehículo utilice la operación
catalogo, pasándole en la etiqueta
‘catalogo’ el valor TIPO_VEHICULO.
vehiculo marca String(25) No Marca del vehículo.
Para obtener los códigos de las
marcas de vehículos utilice la
operación catalogo, pasándole en la
etiqueta ‘catalogo’ el valor
TIPO_MARCA_VEHICULO.
vehiculo modelo String(50) No Modelo del vehículo.
vehiculo matricula String(25) No Matrícula del vehículo.
vehiculo categoria String(50) No Categoría del vehículo según la
clasificación que haga de sus
vehículos cada empresa de alquiler.
vehiculo bastidor String(17) No Número de bastidor.
vehiculo color String(10) No Color del vehículo.
Para obtener los códigos de los
colores de vehículos utilice la
operación catalogo, pasándole en la
etiqueta ‘catalogo’ el valor
TIPO_COLOR.
vehiculo kmRecogida Numérico No Número de kilómetros que tiene el
vehículo en el momento de su
recogida.
vehiculo kmDevolucion Numérico No Número de kilómetros que tiene el
vehículo en el momento de su
devolución.
vehiculo datosGps String(50) No Datos del GPS del vehículo.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 60 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Ubicación Nombre parámetro Tipo Obligatorio Descripción
vehiculo tipo String(50) No Tipo de vehículo.
Para obtener los códigos de los tipos
de vehículo utilice la operación
catalogo, pasándole en la etiqueta
‘catalogo’ el valor TIPO_VEHICULO.
vehiculo marca String(25) No Marca del vehículo.
Para obtener los códigos de las
marcas de vehículos utilice la
operación catalogo, pasándole en la
etiqueta ‘catalogo’ el valor
TIPO_MARCA_VEHICULO.
vehiculo modelo String(50) No Modelo del vehículo.
vehiculo matricula String(25) No Matrícula del vehículo.
vehiculo categoria String(50) No Categoría del vehículo según la
clasificación que haga de sus
vehículos cada empresa de alquiler.
vehiculo bastidor String(17) No Número de bastidor.
vehiculo color String(10) No Color del vehículo.
Para obtener los códigos de los
colores de vehículos utilice la
operación catalogo, pasándole en la
etiqueta ‘catalogo’ el valor
TIPO_COLOR.
vehiculo kmRecogida Numérico No Número de kilómetros que tiene el
vehículo en el momento de su
recogida.
vehiculo kmDevolucion Numérico No Número de kilómetros que tiene el
vehículo en el momento de su
devolución.
vehiculo datosGps String(50) No Datos del GPS del vehículo.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 61 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.4. ANULAR COMUNICACIONES DE UN LOTE
Esta operación permite anular todas las comunicaciones de un lote.
En el mensaje de petición se deberá informar del código del lote que se desea anular. Solo se
permite anular un lote por petición.
Operación → anulacionLote
Figura 27. Mensajes para la operación anulacionLote
3.4.1. Solicitud
A continuación se recoge el esquema de validación de la petición que debe recibir el Servicio de
Comunicación para la operación de anular las comunicaciones de un lote.
Figura 28. Mensaje de petición de la operación anulacionLote
3.4.2. Respuesta
A continuación se recoge el esquema de validación del mensaje de respuesta que devuelve el
servicio tras una petición a la operación de anular las comunicaciones de un lote.
Figura 29. Mensaje de respuesta de la operación anulacionLote
Ubicación Nombre parámetro Tipo Obligatorio Descripción
anulacionLoteRequest lote String(36) Si Código del lote a anular
Cliente Servicio de
Comunicación
canulacionLoteRequest
anulacionLoteResponse
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 61 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.4. ANULAR COMUNICACIONES DE UN LOTE
Esta operación permite anular todas las comunicaciones de un lote.
En el mensaje de petición se deberá informar del código del lote que se desea anular. Solo se
permite anular un lote por petición.
Operación → anulacionLote
Figura 27. Mensajes para la operación anulacionLote
3.4.1. Solicitud
A continuación se recoge el esquema de validación de la petición que debe recibir el Servicio de
Comunicación para la operación de anular las comunicaciones de un lote.
Figura 28. Mensaje de petición de la operación anulacionLote
3.4.2. Respuesta
A continuación se recoge el esquema de validación del mensaje de respuesta que devuelve el
servicio tras una petición a la operación de anular las comunicaciones de un lote.
Figura 29. Mensaje de respuesta de la operación anulacionLote
Ubicación Nombre parámetro Tipo Obligatorio Descripción
anulacionLoteRequest lote String(36) Si Código del lote a anular
Cliente Servicio de
Comunicación
canulacionLoteRequest
anulacionLoteResponse
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 62 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Ubicación Nombre parámetro Tipo Obligatorio Descripción
anulacionLoteResponse codigo Numérico Si Código de respuesta de la petición.
Si la petición se ha tramitado
correctamente, contendrá el valor
0.
En el caso de que el mensaje de
petición contenga algún error y no
se haya podido tramitar, contendrá
un código identificativo del error.
Véase apartado 5. Códigos de error
devueltos por el servicio con los
códigos de respueta en caso de
error.
anulacionLoteResponse descripcion String(100) Si Descripción del código de
respuesta de la petición.
En caso de error en la petición
contendrá un literal descriptivo del
error encontrado.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 62 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Ubicación Nombre parámetro Tipo Obligatorio Descripción
anulacionLoteResponse codigo Numérico Si Código de respuesta de la petición.
Si la petición se ha tramitado
correctamente, contendrá el valor
0.
En el caso de que el mensaje de
petición contenga algún error y no
se haya podido tramitar, contendrá
un código identificativo del error.
Véase apartado 5. Códigos de error
devueltos por el servicio con los
códigos de respueta en caso de
error.
anulacionLoteResponse descripcion String(100) Si Descripción del código de
respuesta de la petición.
En caso de error en la petición
contendrá un literal descriptivo del
error encontrado.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 63 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.5. CONSULTAR CATÁLOGO
Permite obtener una relación de los códigos y descripciones de los datos que se deben enviar en
las diferentes peticiones y que el Sistema de Hospedaje guarda en tablas maestras.
La operación admite un parámetro de entrada para identificar la tabla maestra que se quiera obtener.
Si este parámetro va vacío, retornará una lista con las tablas maestras soportadas.
Inicialmente las tablas maestras soportadas son:
o SEXO
o TIPO_COLOR
o TIPO_DOCUMENTO
o TIPO_ESTABLECIMIENTO
o TIPO_MARCA_VEHICULO
o TIPO_PAGO
o TIPO_PARENTESCO
o TIPO_PERMISO_CONDUCIR
o TIPO_VEHICULO
Operación → catalogo
Figura 30. Mensajes para la operación catalogo
3.5.1. Solicitud
A continuación se recoge el esquema de validación de la petición que debe recibir el Servicio de
Comunicación para la consulta de catálogo.
Figura 31. Mensaje de petición de la operación catalogo
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del mensaje de petición.
Cliente Servicio de
Comunicación
catalogoRequest
catalogoResponse
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 63 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.5. CONSULTAR CATÁLOGO
Permite obtener una relación de los códigos y descripciones de los datos que se deben enviar en
las diferentes peticiones y que el Sistema de Hospedaje guarda en tablas maestras.
La operación admite un parámetro de entrada para identificar la tabla maestra que se quiera obtener.
Si este parámetro va vacío, retornará una lista con las tablas maestras soportadas.
Inicialmente las tablas maestras soportadas son:
o SEXO
o TIPO_COLOR
o TIPO_DOCUMENTO
o TIPO_ESTABLECIMIENTO
o TIPO_MARCA_VEHICULO
o TIPO_PAGO
o TIPO_PARENTESCO
o TIPO_PERMISO_CONDUCIR
o TIPO_VEHICULO
Operación → catalogo
Figura 30. Mensajes para la operación catalogo
3.5.1. Solicitud
A continuación se recoge el esquema de validación de la petición que debe recibir el Servicio de
Comunicación para la consulta de catálogo.
Figura 31. Mensaje de petición de la operación catalogo
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del mensaje de petición.
Cliente Servicio de
Comunicación
catalogoRequest
catalogoResponse
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 64 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.5.2. Respuesta
A continuación se recoge el esquema de validación del mensaje de respuesta que devuelve el
servicio tras una petición de consulta de catálogo.
Figura 32. Mensaje de respuesta de la operación catalogo
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del mensaje de respuesta.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
catalogoRequest peticion BLOQUE Si Contiene los datos de la petición.
catalogoRequest /
peticion
catalogo String No Nombre de la tabla maestra a
consultar. Si no se envía este dato, el
servicio retorna una lista de las tablas
maestras disponibles.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
catalogoResponse resultado BLOQUE Si Bloque único.
Contiene los datos de control relativos
al estado de la respuesta.
catalogoResponse /
resultado
codigo Numérico Si Código identificativo del estado de la
petición.
Véase apartado 4. Código de estado
devueltos por el servicio con los
códigos de estado en caso de error.
catalogoResponse /
resultado
descripcion String No Descripción del estado de la petición.
En caso de error en la petición
contendrá un literal descriptivo del
error encontrado.
catalogoResponse respuesta BLOQUE Si Bloque único.
Contiene la información de respuesta
de la consulta.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 64 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
3.5.2. Respuesta
A continuación se recoge el esquema de validación del mensaje de respuesta que devuelve el
servicio tras una petición de consulta de catálogo.
Figura 32. Mensaje de respuesta de la operación catalogo
En la siguiente tabla se resume el tipo de dato y la información que contiene cada uno de los campos
del mensaje de respuesta.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
catalogoRequest peticion BLOQUE Si Contiene los datos de la petición.
catalogoRequest /
peticion
catalogo String No Nombre de la tabla maestra a
consultar. Si no se envía este dato, el
servicio retorna una lista de las tablas
maestras disponibles.
Ubicación Nombre parámetro Tipo Obligatorio Descripción
catalogoResponse resultado BLOQUE Si Bloque único.
Contiene los datos de control relativos
al estado de la respuesta.
catalogoResponse /
resultado
codigo Numérico Si Código identificativo del estado de la
petición.
Véase apartado 4. Código de estado
devueltos por el servicio con los
códigos de estado en caso de error.
catalogoResponse /
resultado
descripcion String No Descripción del estado de la petición.
En caso de error en la petición
contendrá un literal descriptivo del
error encontrado.
catalogoResponse respuesta BLOQUE Si Bloque único.
Contiene la información de respuesta
de la consulta.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 65 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
catalogoResponse /
respuesta
resultado BLOQUE Si Contiene los elementos que coinciden
con los criterios de búsqueda
solicitados.
catalogoResponse /
respuesta / resultado
tupla BLOQUE No Bloque que se repite de 0 a n veces.
Contiene los valores de la tabla
maestra solicitada.
Si en la petición no se indicó ninguna
tabla, devuelve las tablas maestras
soportadas.
catalogoResponse /
respuesta / resultado /
tupla
codigo String Si Indica un código de la tabla maestra
consultada.
Si no se indicó tabla en la petición,
devuelve el nombre de una de las
tablas maestras soportadas.
catalogoResponse /
respuesta / resultado /
tupla
descripcion String Si Devuelve la descripción del código o el
nombre de la tabla maestra.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 65 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
catalogoResponse /
respuesta
resultado BLOQUE Si Contiene los elementos que coinciden
con los criterios de búsqueda
solicitados.
catalogoResponse /
respuesta / resultado
tupla BLOQUE No Bloque que se repite de 0 a n veces.
Contiene los valores de la tabla
maestra solicitada.
Si en la petición no se indicó ninguna
tabla, devuelve las tablas maestras
soportadas.
catalogoResponse /
respuesta / resultado /
tupla
codigo String Si Indica un código de la tabla maestra
consultada.
Si no se indicó tabla en la petición,
devuelve el nombre de una de las
tablas maestras soportadas.
catalogoResponse /
respuesta / resultado /
tupla
descripcion String Si Devuelve la descripción del código o el
nombre de la tabla maestra.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 66 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 66 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 67 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
4. FORMATO DE BLOQUES COMUNES EN LOS MENSAJES DE PETICIÓN Y RESPUESTA
4.1. BLOQUE DIRECCION
Contenido del bloque direccion que se incluye en los mensajes de varias operaciones del servicio.
Figura 33. Bloque común direccion en mensajes de petición
En la siguiente tabla se enumeran cada uno de los campos del bloque.
Ubicación Nombre
parámetro
Tipo Obligatorio Descripción
direccion direccion String(100) Si Calle, número, escalera, piso, puerta,
y demás campos que indiquen la
dirección.
direccion direccionComplem
entaria
String(100) No Campo adicional para indicar la
dirección.
direccion codigoMunicipio String(5) Obligatorio
cuando el país es
España
Municipio.
Este campo irá codificado con los
códigos de municipios del INE (5
dígitos).
direccion nombreMunicipio String(100) Obligatorio
cuando el país no
es España
Nombre del municipio, ciudad, estado,
etc.
direccion codigoPostal String(20) Si Código postal.
direccion pais String(3) Si Código del país.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 67 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
4. FORMATO DE BLOQUES COMUNES EN LOS MENSAJES DE PETICIÓN Y RESPUESTA
4.1. BLOQUE DIRECCION
Contenido del bloque direccion que se incluye en los mensajes de varias operaciones del servicio.
Figura 33. Bloque común direccion en mensajes de petición
En la siguiente tabla se enumeran cada uno de los campos del bloque.
Ubicación Nombre
parámetro
Tipo Obligatorio Descripción
direccion direccion String(100) Si Calle, número, escalera, piso, puerta,
y demás campos que indiquen la
dirección.
direccion direccionComplem
entaria
String(100) No Campo adicional para indicar la
dirección.
direccion codigoMunicipio String(5) Obligatorio
cuando el país es
España
Municipio.
Este campo irá codificado con los
códigos de municipios del INE (5
dígitos).
direccion nombreMunicipio String(100) Obligatorio
cuando el país no
es España
Nombre del municipio, ciudad, estado,
etc.
direccion codigoPostal String(20) Si Código postal.
direccion pais String(3) Si Código del país.
Este campo va codificado según la
norma ISO 3166-1 Alfa-3.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 68 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
4.2. BLOQUE PAGO
Contenido del bloque pago que se incluye en los mensajes de varias operaciones del servicio.
Figura 34. Bloque común pago en mensajes de petición
En la siguiente tabla se enumeran cada uno de los campos del bloque.
Ubicación Nombre
parámetro
Tipo Obligatorio Descripción
pago tipoPago String(5) Si Tipo de pago.
Para obtener los códigos de los tipos
de documento utilice la operación
catalogo, pasándole en la etiqueta
‘catalogo’ el valor TIPO_PAGO.
pago fechaPago Fecha No Fecha en la que se efectuó el pago.
Formato AAAA-MM-DD.
pago medioPago String(50) No Identificación del medio de pago: tipo
de tarjeta y número, IBAN cuenta
bancaria, número de móvil, etc.
pago titular String(100) No Nombre y apellidos del titular del
pago.
pago caducidadTarjeta String(7) No Fecha de caducidad de la tarjeta en
caso de pago con tarjeta.
Formato MM/AAAA.
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 68 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
4.2. BLOQUE PAGO
Contenido del bloque pago que se incluye en los mensajes de varias operaciones del servicio.
Figura 34. Bloque común pago en mensajes de petición
En la siguiente tabla se enumeran cada uno de los campos del bloque.
Ubicación Nombre
parámetro
Tipo Obligatorio Descripción
pago tipoPago String(5) Si Tipo de pago.
Para obtener los códigos de los tipos
de documento utilice la operación
catalogo, pasándole en la etiqueta
‘catalogo’ el valor TIPO_PAGO.
pago fechaPago Fecha No Fecha en la que se efectuó el pago.
Formato AAAA-MM-DD.
pago medioPago String(50) No Identificación del medio de pago: tipo
de tarjeta y número, IBAN cuenta
bancaria, número de móvil, etc.
pago titular String(100) No Nombre y apellidos del titular del
pago.
pago caducidadTarjeta String(7) No Fecha de caducidad de la tarjeta en
caso de pago con tarjeta.
Formato MM/AAAA.
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 69 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
5. CÓDIGOS DE ERROR DEVUELTOS POR EL SERVICIO
En este apartado se recogen todos los códigos enviados en los mensajes de respuesta del servicio.
Código del retorno Descripción
0 Ok
10100 No ha informado el código de arrendador
10101 No ha informado el código de aplicación
10103 El código de arrendador no existe en el sistema
10107 Usuario incorrecto
10108 No ha informado la petición
10109 No ha informado la cabecera
10110 No ha informado la solicitud
10111 Formato de solicitud incorrecto. Ha de ser un fichero xml en UTF-8, comprimido
(zip) y codificado en Base64
10112 No ha informado el código de la operación
10113 El código de comunicación no existe en el sistema
10116 No ha informado el tipo de la comunicación
10117 La operación sólo podrá tener como valores 'A', 'C' ó 'B'
10118 Error en el formato de fichero XML
10119 El arrendador no puede realizar ese tipo de comunicaciones
10120 El arrendador no tiene habilitada la opción de realizar operaciones a través del
servicio web
10121 Error de validación
10122 Tipo de comunicación no válido. Valores aceptados: ‘PV’, ‘RH’, ‘AV’, ‘RV’
10128 EL usuario no está indicado en la cabecera
10130 Valor incorrecto para el campo: $NOMBRE_CAMPO
10131 Es obligatorio indicar un valor en el campo: $NOMBRE_CAMPO
10136 Se ha superado el número máximo de comunicaciones a consultar
10140 Solicitud no informada
10150 Se ha superado el número máximo de caracteres de la aplicación
10159 El tipo de comunicación informado no es válido.
10160 No ha informado del código de la comunicación
10180 El formato del código de comunicación no es valido
10999 Error no controlado
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 69 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
5. CÓDIGOS DE ERROR DEVUELTOS POR EL SERVICIO
En este apartado se recogen todos los códigos enviados en los mensajes de respuesta del servicio.
Código del retorno Descripción
0 Ok
10100 No ha informado el código de arrendador
10101 No ha informado el código de aplicación
10103 El código de arrendador no existe en el sistema
10107 Usuario incorrecto
10108 No ha informado la petición
10109 No ha informado la cabecera
10110 No ha informado la solicitud
10111 Formato de solicitud incorrecto. Ha de ser un fichero xml en UTF-8, comprimido
(zip) y codificado en Base64
10112 No ha informado el código de la operación
10113 El código de comunicación no existe en el sistema
10116 No ha informado el tipo de la comunicación
10117 La operación sólo podrá tener como valores 'A', 'C' ó 'B'
10118 Error en el formato de fichero XML
10119 El arrendador no puede realizar ese tipo de comunicaciones
10120 El arrendador no tiene habilitada la opción de realizar operaciones a través del
servicio web
10121 Error de validación
10122 Tipo de comunicación no válido. Valores aceptados: ‘PV’, ‘RH’, ‘AV’, ‘RV’
10128 EL usuario no está indicado en la cabecera
10130 Valor incorrecto para el campo: $NOMBRE_CAMPO
10131 Es obligatorio indicar un valor en el campo: $NOMBRE_CAMPO
10136 Se ha superado el número máximo de comunicaciones a consultar
10140 Solicitud no informada
10150 Se ha superado el número máximo de caracteres de la aplicación
10159 El tipo de comunicación informado no es válido.
10160 No ha informado del código de la comunicación
10180 El formato del código de comunicación no es valido
10999 Error no controlado
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 70 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
6. ANEXO I. EJEMPLO DE ALTA DE COMUNICACIONES
A continuación, se incluye un ejemplo de petición y otro de respuesta de la operación comunicación.
El ejemplo está construido para enviar una petición del tipo parte de viajeros (PV) y la operación de
alta (A)
Mensaje de petición:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:com="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<soapenv:Header/>
<soapenv:Body>
<com:comunicacionRequest>
<peticion>
<cabecera>
<codigoArrendador>0000000001</codigoArrendador>
<aplicacion>Centro de reservas de prueba</aplicacion>
<tipoOperacion>A</tipoOperacion>
<tipoComunicacion>PV</tipoComunicacion>
</cabecera>
<solicitud>Fichero XML comprimido en ZIP y codificado en Base64</solicitud>
</peticion>
</com:comunicacionRequest>
</soapenv:Body>
</soapenv:Envelope>
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 70 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
6. ANEXO I. EJEMPLO DE ALTA DE COMUNICACIONES
A continuación, se incluye un ejemplo de petición y otro de respuesta de la operación comunicación.
El ejemplo está construido para enviar una petición del tipo parte de viajeros (PV) y la operación de
alta (A)
Mensaje de petición:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:com="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<soapenv:Header/>
<soapenv:Body>
<com:comunicacionRequest>
<peticion>
<cabecera>
<codigoArrendador>0000000001</codigoArrendador>
<aplicacion>Centro de reservas de prueba</aplicacion>
<tipoOperacion>A</tipoOperacion>
<tipoComunicacion>PV</tipoComunicacion>
</cabecera>
<solicitud>Fichero XML comprimido en ZIP y codificado en Base64</solicitud>
</peticion>
</com:comunicacionRequest>
</soapenv:Body>
</soapenv:Envelope>
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 71 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Mensaje de respuesta ok:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:comunicacionResponse
xmlns:ns3="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<respuesta>
<codigoRetorno>0</codigoRetorno>
<descripcion>Ok</descripcion>
<lote>00000000-0000-0000-0000-000000000000</lote>
</respuesta>
</ns3:comunicacionResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Mensaje de respuesta error:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:comunicacionResponse
xmlns:ns3="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<respuesta>
<codigoRetorno>109</codigoRetorno>
<descripcion>Formato de solicitud incorrecto. Ha de ir comprimido (zip) y codificado
en Base64.</descripcion>
</respuesta>
</ns3:comunicacionResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Contenido del fichero XML:
<alt:peticion xmlns:alt="http://www.neg.hospedajes.mir.es/altaParteHospedaje">
<solicitud>
<codigoEstablecimiento>1234567890</codigoEstablecimiento>
<comunicacion>
<contrato>
<referencia>string</referencia>
<fechaContrato>2022-09-29</fechaContrato>
<fechaEntrada>2022-09-19T01:18:33</fechaEntrada>
<fechaSalida>2022-09-21T19:27:14+02:00</fechaSalida>
<numPersonas>2</numPersonas>
<numHabitaciones>1</numHabitaciones>
<internet>false</internet>
<pago>
<tipoPago>EFECT</tipoPago>
<fechaPago>2022-09-29</fechaPago>
</pago>
</contrato>
<persona>
<rol>VI</rol>
<nombre>Juan</nombre>
<apellido1>García</apellido1>
<apellido2>García</apellido2>
<tipoDocumento>NIFº</tipoDocumento>
<numeroDocumento>000000000T</numeroDocumento>
<soporteDocumento>999999999</soporteDocumento>
<fechaNacimiento>1999-01-01</fechaNacimiento>
<nacionalidad>ESP</nacionalidad>
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 71 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Mensaje de respuesta ok:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:comunicacionResponse
xmlns:ns3="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<respuesta>
<codigoRetorno>0</codigoRetorno>
<descripcion>Ok</descripcion>
<lote>00000000-0000-0000-0000-000000000000</lote>
</respuesta>
</ns3:comunicacionResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Mensaje de respuesta error:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:comunicacionResponse
xmlns:ns3="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<respuesta>
<codigoRetorno>109</codigoRetorno>
<descripcion>Formato de solicitud incorrecto. Ha de ir comprimido (zip) y codificado
en Base64.</descripcion>
</respuesta>
</ns3:comunicacionResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Contenido del fichero XML:
<alt:peticion xmlns:alt="http://www.neg.hospedajes.mir.es/altaParteHospedaje">
<solicitud>
<codigoEstablecimiento>1234567890</codigoEstablecimiento>
<comunicacion>
<contrato>
<referencia>string</referencia>
<fechaContrato>2022-09-29</fechaContrato>
<fechaEntrada>2022-09-19T01:18:33</fechaEntrada>
<fechaSalida>2022-09-21T19:27:14+02:00</fechaSalida>
<numPersonas>2</numPersonas>
<numHabitaciones>1</numHabitaciones>
<internet>false</internet>
<pago>
<tipoPago>EFECT</tipoPago>
<fechaPago>2022-09-29</fechaPago>
</pago>
</contrato>
<persona>
<rol>VI</rol>
<nombre>Juan</nombre>
<apellido1>García</apellido1>
<apellido2>García</apellido2>
<tipoDocumento>NIFº</tipoDocumento>
<numeroDocumento>000000000T</numeroDocumento>
<soporteDocumento>999999999</soporteDocumento>
<fechaNacimiento>1999-01-01</fechaNacimiento>
<nacionalidad>ESP</nacionalidad>
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 72 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
<sexo>H</sexo>
<direccion>
<direccion>C/Serrano 127</direccion>
<direccionComplementaria>Portal A. 2ºB</direccionComplementaria>
<codigoMunicipio>28079</codigoMunicipio>
<codigoPostal>28001</codigoPostal>
<pais>ESP</pais>
</direccion>
<telefono>666666666</telefono>
<correo>juangarcia@correo.es</correo>
</persona>
<persona>
<rol>VI</rol>
<nombre>Pedro</nombre>
<apellido1>García</apellido1>
<apellido2>Fernández</apellido2>
<fechaNacimiento>2018-01-01</fechaNacimiento>
<nacionalidad>ESP</nacionalidad>
<sexo>H</sexo>
<direccion>
<direccion>C/Serrano 127</direccion>
<direccionComplementaria>Portal A. 2ºB</direccionComplementaria>
<codigoMunicipio>28079</codigoMunicipio>
<codigoPostal>28001</codigoPostal>
<pais>ESP</pais>
</direccion>
<telefono>666666666</telefono>
<correo>juangarcia@correo.es</correo>
<parentesco>HJ</parentesco>
</persona>
</comunicacion>
</solicitud>
</alt:peticion>
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 72 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
<sexo>H</sexo>
<direccion>
<direccion>C/Serrano 127</direccion>
<direccionComplementaria>Portal A. 2ºB</direccionComplementaria>
<codigoMunicipio>28079</codigoMunicipio>
<codigoPostal>28001</codigoPostal>
<pais>ESP</pais>
</direccion>
<telefono>666666666</telefono>
<correo>juangarcia@correo.es</correo>
</persona>
<persona>
<rol>VI</rol>
<nombre>Pedro</nombre>
<apellido1>García</apellido1>
<apellido2>Fernández</apellido2>
<fechaNacimiento>2018-01-01</fechaNacimiento>
<nacionalidad>ESP</nacionalidad>
<sexo>H</sexo>
<direccion>
<direccion>C/Serrano 127</direccion>
<direccionComplementaria>Portal A. 2ºB</direccionComplementaria>
<codigoMunicipio>28079</codigoMunicipio>
<codigoPostal>28001</codigoPostal>
<pais>ESP</pais>
</direccion>
<telefono>666666666</telefono>
<correo>juangarcia@correo.es</correo>
<parentesco>HJ</parentesco>
</persona>
</comunicacion>
</solicitud>
</alt:peticion>
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 73 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
7. ANEXO II. EJEMPLO DE CONSULTA DE LOTES
A continuación, se incluye un ejemplo de petición y otro de respuesta de la operación comunicación.
El ejemplo está construido para enviar una petición de la operación de consulta (C).
Mensaje de petición:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:com="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<soapenv:Header/>
<soapenv:Body>
<com:comunicacionRequest>
<peticion>
<cabecera>
<codigoArrendador>0000000001</codigoArrendador>
<aplicacion>Centro de reservas de prueba</aplicacion>
<tipoOperacion>C</tipoOperacion>
</cabecera>
<solicitud>Fichero XML comprimido en ZIP y codificado en Base64</solicitud>
</peticion>
</com:comunicacionRequest>
</soapenv:Body>
</soapenv:Envelope>
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 73 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
7. ANEXO II. EJEMPLO DE CONSULTA DE LOTES
A continuación, se incluye un ejemplo de petición y otro de respuesta de la operación comunicación.
El ejemplo está construido para enviar una petición de la operación de consulta (C).
Mensaje de petición:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:com="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<soapenv:Header/>
<soapenv:Body>
<com:comunicacionRequest>
<peticion>
<cabecera>
<codigoArrendador>0000000001</codigoArrendador>
<aplicacion>Centro de reservas de prueba</aplicacion>
<tipoOperacion>C</tipoOperacion>
</cabecera>
<solicitud>Fichero XML comprimido en ZIP y codificado en Base64</solicitud>
</peticion>
</com:comunicacionRequest>
</soapenv:Body>
</soapenv:Envelope>
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 74 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Mensaje de respuesta ok:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:comunicacionResponse
xmlns:ns3="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<respuesta>
<codigo>0</codigo>
<descripcion>Ok</descripcion>
</respuesta>
<resultado>
<lote>00000000-0000-0000-0000-000000000000</lote>
<tipoComuniacion>PV</tipoComuniacion>
<tipoOperacion>A</tipoOperacion>
<fechaPeticion>2023-02-23T11:37:13.000+01:00</fechaPeticion>
<fechaProcesamiento>2023-02-23T11:37:33.000+01:00</fechaProcesamiento>
<codigoEstado>6</codigoEstado>
<descEstado>Se ha ejecutado pero hay errores en algunas comunicaciones</descEstado>
<identificadorUsuario>B00000000</identificadorUsuario>
<nombreUsuario>Prueba</nombreUsuario>
<codigoArrendador>0000000001</codigoArrendador>
<aplicacion>Sistema de pruebas</aplicacion>
<resultadoComunicaciones>
<resutadoComunicacion>
<orden>1</orden>
<tipoError>Error validación de datos</tipoError>
<error>Error de validación en la comunicación [1]: [No existe un establecimiento
para ese código. codigoEstablecimiento: [1234567890]]</error>
</resutadoComunicacion>
</resultadoComunicaciones>
</resultado>
</ns3:comunicacionResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Contenido del fichero XML:
<con:lotes xmlns:con="http://www.neg.hospedajes.mir.es/consultarComunicacion">
<!--1 or more repetitions:-->
<con:lote>00000000-0000-0000-0000-000000000000</con:lote>
</con:lotes>
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 74 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Mensaje de respuesta ok:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:comunicacionResponse
xmlns:ns3="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<respuesta>
<codigo>0</codigo>
<descripcion>Ok</descripcion>
</respuesta>
<resultado>
<lote>00000000-0000-0000-0000-000000000000</lote>
<tipoComuniacion>PV</tipoComuniacion>
<tipoOperacion>A</tipoOperacion>
<fechaPeticion>2023-02-23T11:37:13.000+01:00</fechaPeticion>
<fechaProcesamiento>2023-02-23T11:37:33.000+01:00</fechaProcesamiento>
<codigoEstado>6</codigoEstado>
<descEstado>Se ha ejecutado pero hay errores en algunas comunicaciones</descEstado>
<identificadorUsuario>B00000000</identificadorUsuario>
<nombreUsuario>Prueba</nombreUsuario>
<codigoArrendador>0000000001</codigoArrendador>
<aplicacion>Sistema de pruebas</aplicacion>
<resultadoComunicaciones>
<resutadoComunicacion>
<orden>1</orden>
<tipoError>Error validación de datos</tipoError>
<error>Error de validación en la comunicación [1]: [No existe un establecimiento
para ese código. codigoEstablecimiento: [1234567890]]</error>
</resutadoComunicacion>
</resultadoComunicaciones>
</resultado>
</ns3:comunicacionResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Contenido del fichero XML:
<con:lotes xmlns:con="http://www.neg.hospedajes.mir.es/consultarComunicacion">
<!--1 or more repetitions:-->
<con:lote>00000000-0000-0000-0000-000000000000</con:lote>
</con:lotes>
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 75 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
8. ANEXO III. EJEMPLO DE ANULACIÓN DE COMUNICACIONES
A continuación, se incluye un ejemplo de petición y otro de respuesta de la operación comunicación.
El ejemplo está construido para enviar una petición de la operación de anulación (B).
Mensaje de petición:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:com="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<soapenv:Header/>
<soapenv:Body>
<com:comunicacionRequest>
<peticion>
<cabecera>
<codigoArrendador>0000000001</codigoArrendador>
<aplicacion>Centro de reservas de prueba</aplicacion>
<tipoOperacion>B</tipoOperacion>
</cabecera>
<solicitud>Fichero XML comprimido en ZIP y codificado en Base64</solicitud>
</peticion>
</com:comunicacionRequest>
</soapenv:Body>
</soapenv:Envelope>
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 75 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
8. ANEXO III. EJEMPLO DE ANULACIÓN DE COMUNICACIONES
A continuación, se incluye un ejemplo de petición y otro de respuesta de la operación comunicación.
El ejemplo está construido para enviar una petición de la operación de anulación (B).
Mensaje de petición:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:com="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<soapenv:Header/>
<soapenv:Body>
<com:comunicacionRequest>
<peticion>
<cabecera>
<codigoArrendador>0000000001</codigoArrendador>
<aplicacion>Centro de reservas de prueba</aplicacion>
<tipoOperacion>B</tipoOperacion>
</cabecera>
<solicitud>Fichero XML comprimido en ZIP y codificado en Base64</solicitud>
</peticion>
</com:comunicacionRequest>
</soapenv:Body>
</soapenv:Envelope>
MINISTERIO
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 76 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Mensaje de respuesta ok:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:comunicacionResponse
xmlns:ns3="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<respuesta>
<codigoRetorno>0</codigoRetorno>
<descripcion>Ok</descripcion>
<lote>00000000-0000-0000-0000-000000000000</lote>
</respuesta>
</ns3:comunicacionResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Contenido del fichero XML:
<anul:comunicaciones xmlns:anul="http://www.neg.hospedajes.mir.es/anularComunicacion">
<!--1 or more repetitions:-->
<anul:codigoComunicacion>44444444-4444-4444-4444-444444444441</anul:codigoComunicacion>
<anul:codigoComunicacion>44444444-4444-4444-4444-444444444442</anul:codigoComunicacion>
<anul:codigoComunicacion>44444444-4444-4444-4444-444444444443</anul:codigoComunicacion>
<anul:codigoComunicacion>44444444-4444-4444-4444-444444444444</anul:codigoComunicacion>
</anul:comunicaciones>
DEL INTERIOR
Interfaz servicios externos
Servicio de Comunicación
Hospedajes
SECRETARÍA DE ESTADO DE
SEGURIDAD
SUBDIRECCIÓN GENERAL DE
SISTEMAS DE INFORMACIÓN Y
COMUNICACIONES PARA LA
SEGURIDAD
Página 76 de 76
MIR-HOSPE-DSI-WS-Servicio de Hospedajes - Comunicaciones v3.1.2.docx
Mensaje de respuesta ok:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:comunicacionResponse
xmlns:ns3="http://www.soap.servicios.hospedajes.mir.es/comunicacion">
<respuesta>
<codigoRetorno>0</codigoRetorno>
<descripcion>Ok</descripcion>
<lote>00000000-0000-0000-0000-000000000000</lote>
</respuesta>
</ns3:comunicacionResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Contenido del fichero XML:
<anul:comunicaciones xmlns:anul="http://www.neg.hospedajes.mir.es/anularComunicacion">
<!--1 or more repetitions:-->
<anul:codigoComunicacion>44444444-4444-4444-4444-444444444441</anul:codigoComunicacion>
<anul:codigoComunicacion>44444444-4444-4444-4444-444444444442</anul:codigoComunicacion>
<anul:codigoComunicacion>44444444-4444-4444-4444-444444444443</anul:codigoComunicacion>
<anul:codigoComunicacion>44444444-4444-4444-4444-444444444444</anul:codigoComunicacion>
</anul:comunicaciones>